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

Attachment

url
String!,non-null
name
String
type
String
size
Float
duration
Float
locationData
Sample
{ "url": "Example String", "name": "Example String", "type": "Example String", "size": 40, "duration": 40, "locationData": { "__typename": "LocationData" } }

ColumnConfigItem

name
String
label
String
order
Int
Sample
{ "name": "Example String", "label": "Example String", "order": 40 }

ConvertedToCardPayload

Payload for converted_to_card action.

cardType
String
performedBy
String
performedByUser

Resolved user who performed the conversion.

Sample
{ "cardType": "Example String", "performedBy": "Example String", "performedByUser": { "__typename": "User" } }
Referenced in

EmailAddress

An email address with optional display name.

name
String

Display name (e.g. 'John Doe').

address
String!,non-null

Email address (e.g. 'john@example.com').

Sample
{ "name": "Example String", "address": "Example String" }

EmailAttachment

Email-specific attachment metadata.

filename
String

Original filename.

mimeType
String

MIME type.

size
Int

File size in bytes.

contentId
String

Content-ID for inline/embedded images.

attachmentId
String

Server-side storage ID for download.

Sample
{ "filename": "Example String", "mimeType": "Example String", "size": 40, "contentId": "Example String", "attachmentId": "Example String" }

HealthEntity

entity_type
String
id
String
can_send_message
String
additional_info
[String]
Sample
{ "entity_type": "Example String", "id": "Example String", "can_send_message": "Example String", "additional_info": [ "Example String" ] }

InboxField

Available custom field definitions for inbox entities.

customer

Custom fields available on customer records.

conversation

Custom fields available on conversations.

device

Custom fields available on device/browser data.

Sample
{ "customer": [ { "__typename": "Field" } ], "conversation": [ { "__typename": "Field" } ], "device": [ { "__typename": "Field" } ] }

KnowledgeBaseArticle

A knowledge base article containing help content, documentation, or guides. Articles belong to categories within topics and support rich content, attachments, and reactions.

_id
String!,non-null
code
String

Unique code identifier for programmatic access.

title
String

The article title.

summary
String

Brief summary or excerpt of the article content.

content
String

Full article content (HTML).

status
String

Publication status: 'draft', 'publish', or 'scheduled'.

isPrivate
Boolean

Whether this article is only visible to team members.

reactionChoices
[String]

Available emoji reaction types for this article.

reactionCounts

Count of each reaction type received.

createdBy
String

User ID of the article creator.

createdUser

The resolved user who created this article.

createdDate

When this article was created.

modifiedBy
String

User ID of the last modifier.

modifiedDate

When this article was last modified.

topicId
String

The topic this article belongs to.

categoryId
String

The category this article belongs to.

viewCount
Int

Total number of times this article has been viewed.

attachments

File attachments included with this article.

Featured image for the article.

pdfAttachment

PDF attachment with extracted page images.

publishedUserId
String

User ID of who published this article.

publishedUser

The resolved user who published this article.

scheduledDate

Scheduled publication date (for status 'scheduled').

Forms embedded in this article.

Sample
{ "_id": "Example String", "code": "Example String", "title": "Example String", "summary": "Example String", "content": "Example String", "status": "Example String", "isPrivate": true, "reactionChoices": [ "Example String" ], "reactionCounts": "Example Custom Scalar", "createdBy": "Example String", "createdUser": { "__typename": "User" }, "createdDate": "Example Custom Scalar", "modifiedBy": "Example String", "modifiedDate": "Example Custom Scalar", "topicId": "Example String", "categoryId": "Example String", "viewCount": 40, "attachments": [ { "__typename": "Attachment" } ], "image": { "__typename": "Attachment" }, "pdfAttachment": { "__typename": "PdfAttachment" }, "publishedUserId": "Example String", "publishedUser": { "__typename": "User" }, "scheduledDate": "Example Custom Scalar", "forms": [ { "__typename": "FormCode" } ] }

KnowledgeBaseArticlesPaginated

Paginated list of knowledge base articles.

The list of articles for the current page.

pagination

Pagination metadata.

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

KnowledgeBaseCategoriesPaginated

Paginated list of knowledge base categories.

The list of categories for the current page.

pagination

Pagination metadata.

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

KnowledgeBaseCategory

A category that groups related knowledge base articles together. Categories can be nested under parent categories for hierarchical organization.

_id
String
code
String

Unique code identifier for programmatic access.

title
String

The category title.

description
String

Description of what this category covers.

Articles in this category, optionally filtered by status.

status
icon
String

Icon identifier for the category.

createdBy
String

User ID of the category creator.

createdDate

When this category was created.

modifiedBy
String

User ID of the last modifier.

modifiedDate

When this category was last modified.

parentCategoryId
String

Parent category ID for nested categorization.

The first topic this category belongs to.

authors

Users who have authored articles in this category.

numOfArticles
Float

Count of articles in this category, optionally filtered by status.

status
countArticles
Int

Total article count in this category.

Sample
{ "_id": "Example String", "code": "Example String", "title": "Example String", "description": "Example String", "articles": [ { "__typename": "KnowledgeBaseArticle" } ], "icon": "Example String", "createdBy": "Example String", "createdDate": "Example Custom Scalar", "modifiedBy": "Example String", "modifiedDate": "Example Custom Scalar", "parentCategoryId": "Example String", "firstTopic": { "__typename": "KnowledgeBaseTopic" }, "authors": [ { "__typename": "User" } ], "numOfArticles": 40, "countArticles": 40 }

Unions

Overview

Enums

Overview

Inputs

Overview

Scalars

Overview