Intercom API (unofficial showcase)
DELETE/companies/{company_id}

Delete a company

Deletes a company from the workspace and detaches its contacts without deleting the contact records. Contact detachment is permanent, and a company.deleted webhook is sent after deletion. A third-party integration may recreate the company on its next sync, so remove or filter it at the source before deleting it here.

2 parameters
company_idstringrequired
The Intercom-assigned unique identifier of the company to delete.
Intercom-Versionstringoptional
Selects the API version. Defaults to `2.17` when omitted; supported versions include 1.0 through 1.4 and 2.0 through 2.6.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

3 status codes
200Returns a deletion result containing the company's ID, the object type `company`, and a boolean indicating whether deletion succeeded.
idstringoptional
The unique identifier for the company which is given by Intercom.
objectstringoptional
The type of object which was deleted. - `company`
Allowed:company
deletedbooleanoptional
Whether the company was deleted successfully or not.
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
404Returned when the company does not exist.

One documented failure

  • company_not_found

    Company Not Found

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. A 404 is returned when the company_id path parameter does not identify an existing company.