Skip to content

Delete a ticket

Request

Irreversible operation

Deleting a ticket is permanent and cannot be reversed.

Deleting a ticket permanently removes it from the inbox. All sensitive data is deleted, including admin and user replies, ticket attributes, uploads, and related content. What happens to the ticket's reporting data depends on the retain_metrics parameter:

  • With retain_metrics=true (default): Deletes the ticket while retaining reporting data. The ticket will still appear in reporting, though some data may be incomplete due to the deletion.

  • With retain_metrics=false: Deletes the ticket and all associated reporting data. The ticket will be completely removed from both the inbox and all reporting.

Required scope for retain_metrics=false

Using retain_metrics=false requires the delete_conversations_and_metrics OAuth scope.

Requires the write_conversations OAuth scope. If the ID refers to a ticket, the access token must also include the write_tickets scope. Without it, the request returns a 401 with the error code token_unauthorized.

Security
bearerAuth
Path
idstringrequired

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

Not the Inbox ticket ID

This is the internal id field from the API response, not the ticket_id displayed in the Intercom Inbox (e.g., #12345). Use the id value from the ticket object returned by the API.

Query
retain_metricsboolean

If true (default), deletes the ticket while retaining reporting data. If false, deletes the ticket and all associated reporting data. Setting to false requires the delete_conversations_and_metrics OAuth scope.

Example:retain_metrics=true
Headers
Intercom-Versionstring(intercom_version)

Intercom API version.
If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.

Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"
Example:Preview
curl -i -X DELETE \
  'https://api.intercom.io/tickets/{id}?retain_metrics=true' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: Preview'

Responses

successful

Bodyapplication/json
idstring

The unique identifier for the ticket.

Example:"5ba682d23d7cf92bef87bfd4"
objectstring

always ticket

Value:"ticket"
Example:"ticket"
deletedboolean

Whether the ticket is deleted or not.

Example:true
Response
{ "id": "632", "object": "ticket", "deleted": true }