Skip to content

GraphQL Overview

Browse queries, mutations, and types in the schema reference. For authentication, endpoint URLs, and domain guides, see the API Overview.

Conversations & messaging

Queries

Overview

Mutations

Overview

Objects

Overview

Enums

Overview
Contacts & CRM

Queries

Overview

Mutations

Overview

Objects

Overview

Inputs

Overview
Products & commerce

Queries

Overview

Mutations

Overview

Objects

Overview
Apps & credentials

Queries

Overview

Mutations

Overview

Objects

Overview
Organization

Queries

Overview

Objects

Overview

Enums

Overview
Other

Queries

Overview

Mutations

Overview

Objects

Overview

KnowledgeBaseSearchResult

Results from a knowledge base semantic search query.

query
String!,non-null

The original search query.

totalResults
Int!,non-null

Total number of matching results.

The search result hits, ordered by relevance.

citations
[JSON!],non-null

Source citations for the results.

Sample
{ "query": "Example String", "totalResults": 40, "results": [ { "__typename": "KnowledgeBaseSearchHit" } ], "citations": [ "Example Custom Scalar" ] }

KnowledgeBaseTopic

A knowledge base topic — the top-level organizational unit. Topics are associated with a brand and contain categories of articles. They can be styled with custom colors and background images.

_id
String!,non-null
code
String

Unique code identifier for programmatic access.

title
String

The topic title.

description
String

Description of the topic.

Categories within this topic.

workspace
color
String
backgroundImage
String

URL of the background image for the topic page.

languageCode
String

ISO language code for the topic content (e.g. 'en', 'ar').

createdBy
String

User ID of the topic creator.

createdDate

When this topic was created.

modifiedBy
String

User ID of the last modifier.

modifiedDate

When this topic was last modified.

Top-level parent categories within this topic.

Sample
{ "_id": "Example String", "code": "Example String", "title": "Example String", "description": "Example String", "categories": [ { "__typename": "KnowledgeBaseCategory" } ], "workspace": { "__typename": "Workspace" }, "color": "Example String", "backgroundImage": "Example String", "languageCode": "Example String", "createdBy": "Example String", "createdDate": "Example Custom Scalar", "modifiedBy": "Example String", "modifiedDate": "Example Custom Scalar", "parentCategories": [ { "__typename": "KnowledgeBaseParentCategory" } ] }

KnowledgeBaseTopicsPaginated

Paginated list of knowledge base topics.

The list of topics for the current page.

pagination

Pagination metadata.

Sample
{ "data": [ { "__typename": "KnowledgeBaseTopic" } ], "pagination": { "__typename": "PaginationInfo" } }

LeadStageHistoryEntry

Single entry in a lead's stage-change history.

stageCode
String!,non-null
at
Date!,non-null
byUserId
String
note
String
Sample
{ "stageCode": "Example String", "at": "Example Custom Scalar", "byUserId": "Example String", "note": "Example String" }

LocationData

latitude
Float
longitude
Float
name
String
address
String
Sample
{ "latitude": 40, "longitude": 40, "name": "Example String", "address": "Example String" }

LocationOption

lat
Float
lng
Float
description
String
Sample
{ "lat": 40, "lng": 40, "description": "Example String" }
Referenced in

Logic

fieldId
String!,non-null
logicOperator
String
logicValue
Sample
{ "fieldId": "Example String", "logicOperator": "Example String", "logicValue": "Example Custom Scalar" }

MessageContext

Threading and forwarding context for a message.

replyTo
String

The message ID this is replying to.

isForwarded
Boolean

Whether this message was forwarded.

mentions
[String]

User IDs mentioned in this message.

Sample
{ "replyTo": "Example String", "isForwarded": true, "mentions": [ "Example String" ] }

MessageDelivery

Delivery status tracking for a message.

status
String!,non-null

Delivery status: 'sending', 'sent', 'delivered', 'seen', 'failed'.

error
String

Error message if delivery failed.

Sample
{ "status": "Example String", "error": "Example String" }

MessageEditEntry

A single edit in a message's edit history.

content
String

The previous content before this edit.

editedAt

When the edit was made.

Sample
{ "content": "Example String", "editedAt": "Example Custom Scalar" }

MessageEmail

Email-specific envelope and body data.

subject
String

Email subject line.

integrationId
String

Integration ID this email belongs to.

Sender address(es).

To recipients.

CC recipients.

BCC recipients (only visible to sender).

references
[String]

RFC 5322 References header chain for threading.

htmlBody
String

Sanitized HTML body.

textBody
String

Plain-text fallback body.

snippet
String

Short preview snippet.

Email-native attachment metadata.

newContent
String

Extracted new content (stripped of quoted/replied text).

quotedContent
String

The quoted/replied portion of the email body.

signature
String

Detected email signature block.

Sample
{ "subject": "Example String", "integrationId": "Example String", "from": [ { "__typename": "EmailAddress" } ], "to": [ { "__typename": "EmailAddress" } ], "cc": [ { "__typename": "EmailAddress" } ], "bcc": [ { "__typename": "EmailAddress" } ], "references": [ "Example String" ], "htmlBody": "Example String", "textBody": "Example String", "snippet": "Example String", "attachments": [ { "__typename": "EmailAttachment" } ], "newContent": "Example String", "quotedContent": "Example String", "signature": "Example String" }

Unions

Overview

Enums

Overview

Inputs

Overview

Scalars

Overview