DocsBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreForumBlogYour Apps

Detach a contact

Example Request & Response

$ curl 'https://api.intercom.io/conversations/<conversation_id>/customers/<contact_id>' \
-X DELETE \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json' \
-H 'Content-Type:application/json' -d

{
  "admin_id": "781345"
}
HTTP/1.1 200 OK

{"customers":[
  {"type":"user","id":"597f02cb22f4bb37597e0b7d"}]
}x§

Removes a Contact from a group conversation.

Request Path Parameters

Parameter

Type

Required?

Description

conversation_id

String

Yes

The identifier for the conversation as given by Intercom.

contact_id

String

Yes

The identifier for the contact as given by Intercom.

Request Body Parameters

Parameter

Type

Required?

Description

admin_id

String

Yes

The id of the admin who is performing the action.

Response

This will return the Contact who was detached from the conversation.