Skip to content
Home/
REST API Reference
/
/
Ticket

Ticket

Tickets are how you track requests from your users.

typestring

Always ticket

Default:"ticket"
Value:"ticket"
Example:"ticket"
idstring

The unique identifier for the ticket which is given by Intercom.

Example:"1295"
ticket_idstring

The ID of the Ticket used in the Intercom Inbox and Messenger. Do not use ticket_id for API queries.

Example:"1390"
ticket_attributesobject(Ticket Attributes)

An object containing the different attributes associated to the ticket as key-value pairs. For the default title and description attributes, the keys are _default_title_ and _default_description_.

Example:
{
  "_default_title_": "Found a bug",
  "_default_description_": "The button's not working"
}
ticket_statestring

The state the ticket is currenly in

Enum:"submitted""in_progress""waiting_on_customer""resolved"
Example:"submitted"
ticket_state_internal_labelstring

The state the ticket is currently in, in a human readable form - visible in Intercom

ticket_state_external_labelstring

The state the ticket is currently in, in a human readable form - visible to customers, in the messenger, email and tickets portal.

ticket_typeobject or null(Ticket Type)

A ticket type, used to define the data fields to be captured in a ticket.

contactsobject(Contacts)

The list of contacts affected by a ticket.

admin_assignee_idstring

The id representing the admin assigned to the ticket.

Example:"1295"
team_assignee_idstring

The id representing the team assigned to the ticket.

Example:"1295"
created_atinteger, (date-time)

The time the ticket was created as a UTC Unix timestamp.

Example:1663597223
updated_atinteger, (date-time)

The last time the ticket was updated as a UTC Unix timestamp.

Example:1663597260
ticket_partsobject(Ticket Parts)

A list of Ticket Part objects for each note and event in the ticket. There is a limit of 500 parts.

is_sharedboolean

Whether or not the ticket is shared with the customer.

Example:true
{
  "type": "ticket",
  "id": "1295",
  "ticket_id": "1390",
  "ticket_attributes": {
    "_default_title_": "Found a bug",
    "_default_description_": "The button's not working"
  },
  "ticket_state": "submitted",
  "ticket_state_internal_label": "string",
  "ticket_state_external_label": "string",
  "ticket_type": {
    "type": "ticket_type",
    "id": "1295",
    "name": "Bug",
    "description": "A bug that has been reported.",
    "icon": "🐞",
    "workspace_id": "ecahpwf5",
    "ticket_type_attributes": { … },
    "archived": false,
    "created_at": 0,
    "updated_at": 0
  },
  "contacts": {
    "type": "contact.list",
    "contacts": [ … ]
  },
  "admin_assignee_id": "1295",
  "team_assignee_id": "1295",
  "created_at": 1663597223,
  "updated_at": 1663597260,
  "ticket_parts": {
    "type": "ticket_part.list",
    "ticket_parts": [ … ],
    "total_count": 2
  },
  "is_shared": true
}