Delete a contact

Example Request & Response

After deletion, how long is the contact archived

When you delete a user/contact/lead, there is a 7 day grace period where intercom can retrieve the information. After 7 days this data will be permanently destroyed.

$ curl https://api.intercom.io/contacts/<id> \\\n-X DELETE \\\n-H 'Authorization:Bearer <Your access token>' \\\n-H 'Accept:application/json'

Example Errors

Contact not found

HTTP/1.1 404 FOUND\n{\n  \"type\": \"error.list\",\n  \"request_id\": \"9a3d0816-9707-4598-977e-c009ba630148\",\n  \"errors\": [\n    {\n      \"code\": \"not_found\",\n      \"message\": \"Contact Not Found\"\n    }\n  ]\n}\n

You can delete a single contact.

Request Path Parameters

Parameter	Type	Required	Description
id	String	Yes	The unique identifier for the contact which is given by Intercom

Response

This will return an object with details on the deleted contact.