Mutation
mutation ImportThread($input: ImportThreadInput!) {
importThread(input: $input) {
thread {
id
ref
customer {
id
externalId
fullName
shortName
email {
__typename
}
avatarUrl
}
title
description
previewText
}
result
error {
message
type
code
fields {
field
message
type
}
}
}
}Variables
{
"input": {
"customerIdentifier": {},
"title": "string",
"externalId": "id",
"priority": 1,
"status": "TODO",
"statusDetail": {
"type": "NEW_REPLY"
},
"createdAt": "string"
}
}Response
{
"data": {
"importThread": {
"thread": {
"id": "id",
"ref": "string",
"customer": {
"id": "id",
"externalId": "id",
"fullName": "string",
"shortName": "string",
"email": {
"__typename": "EmailAddress"
},
"avatarUrl": "string"
},
"title": "string",
"description": "string",
"previewText": "string"
},
"result": "UPDATED",
"error": {
"message": "string",
"type": "VALIDATION",
"code": "string",
"fields": [
{
"field": "string",
"message": "string",
"type": "VALIDATION"
}
]
}
}
}
}Mutations
importThread
Import a thread from an external system using its historical creation timestamp. Unlike createThread, this mutation does not trigger SLAs or autoresponders, making it suitable for backfilling historical support data. The externalId is used for idempotency — re-importing the same ID returns NOOP. Requires the thread:import permission.
MUTATION
importThread(input: ImportThreadInput!): ImportThreadOutput!Arguments
input
required
Returns
thread
result
error
Mutation
mutation ImportThread($input: ImportThreadInput!) {
importThread(input: $input) {
thread {
id
ref
customer {
id
externalId
fullName
shortName
email {
__typename
}
avatarUrl
}
title
description
previewText
}
result
error {
message
type
code
fields {
field
message
type
}
}
}
}Variables
{
"input": {
"customerIdentifier": {},
"title": "string",
"externalId": "id",
"priority": 1,
"status": "TODO",
"statusDetail": {
"type": "NEW_REPLY"
},
"createdAt": "string"
}
}Response
{
"data": {
"importThread": {
"thread": {
"id": "id",
"ref": "string",
"customer": {
"id": "id",
"externalId": "id",
"fullName": "string",
"shortName": "string",
"email": {
"__typename": "EmailAddress"
},
"avatarUrl": "string"
},
"title": "string",
"description": "string",
"previewText": "string"
},
"result": "UPDATED",
"error": {
"message": "string",
"type": "VALIDATION",
"code": "string",
"fields": [
{
"field": "string",
"message": "string",
"type": "VALIDATION"
}
]
}
}
}
}Was this page helpful?

