Issues

Create issues from your systems, read the inbox, and manage status, priority, tags, and assignment.

Issues (tickets) are the core object. Create them from your own systems, read the inbox, and manage status, priority, tags, assignment, and spam/trash state.

Create an issue

mutation Create($input: CreateIssueInput!) {
  createIssue(input: $input) {
    issue { id ticketNumber subject status }
    error { code message fields { path message } }
  }
}

CreateIssueInput fields:

Field	Required	Description
`subject`	Yes	Issue title.
`body`	Yes	First inbound message (plain text).
`priority`	No	`low` \| `normal` \| `high` \| `urgent`.
`requesterEmail`	No	Requester email; used to create/link a contact.
`requesterName`	No	Requester display name.
`contactId`	No	Link to an existing CRM contact (opaque id).
`accountId`	No	Link to an existing CRM account (opaque id).
`tags`	No	Tags to apply.
`externalId`	No	Your stable id; reusing it returns the original issue.
`idempotencyKey`	No	Dedupe key for safe retries.

List the inbox

query Inbox($after: String) {
  issues(first: 25, after: $after, target: all, status: new, sortKey: createdAt) {
    edges { node { id ticketNumber subject status priority lastMessageAt } }
    pageInfo { hasNextPage endCursor }
  }
}

Manage an issue

mutation Triage($id: ID!) {
  setIssueStatus(issueId: $id, status: on_hold) { issue { id status } error { code message } }
  setIssuePriority(issueId: $id, priority: urgent) { issue { id priority } error { code message } }
  setIssueTags(issueId: $id, tags: ["billing", "escalated"]) { issue { id tags } error { code message } }
  assignIssue(issueId: $id, assigneeProfileId: "<profile-id>") { issue { id assignedTo } error { code message } }
}

Other issue mutations: setIssueAccount, setIssueTeams, setIssueSpam, setIssueTrashed, followIssue, unfollowIssue.