Intercom API (unofficial showcase)
DELETE/contacts/{contact_id}

Delete a contact

Deletes a single contact from the workspace. Use the contact's ID to identify the record to remove. The response includes a contact reference and indicates whether the contact was deleted.

2 parameters
contact_idstringrequired
The unique identifier of the contact to delete.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

2 status codes
200Returns a deleted contact object with a contact reference and a `deleted` value indicating whether the contact was deleted.
deletedbooleanoptional
Whether the contact is deleted or not.
typestringoptional
always contact
Allowed:contact
idstringoptional
The unique identifier for the contact which is given by Intercom.
external_idstringoptional
The unique identifier for the contact which is provided by the Client.
401Returned when the request is unauthorized.

One documented failure

  • unauthorized

    Access Token Invalid

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 401 is returned when the request is unauthorized. The contact_id path parameter must identify the contact to delete.