Skip to content
Home/
REST API Reference
/
/
Delete a company

Delete a company

Request

Delete a single company.

This endpoint does not permanently remove the company. It archives the company record and detaches any contacts attached to it; the contacts themselves are not deleted. A company.deleted webhook is sent once archival completes.

The endpoint returns 200 with "deleted": true as soon as the request is accepted — archival is processed asynchronously.

Third-party integrations that sync companies into Intercom (for example, Salesforce or Chargebee) will recreate any company deleted through this endpoint on their next sync. To prevent recreation, remove or filter the company at the source integration before deleting it via the API.

Security
bearerAuth
Path
idstringrequired

The unique identifier for the company which is given by Intercom

Example:5f4d3c1c-7b1b-4d7d-a97e-6095715c6632
Headers
Intercom-Versionstring(intercom_version)

Intercom API version.
By default, it's equal to the version set in the app package.

Default:"2.9"
Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"
Example:2.9
curl -i -X DELETE \
  https://api.intercom.io/companies/5f4d3c1c-7b1b-4d7d-a97e-6095715c6632 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: 2.9'

Responses

Successful

Bodyapplication/json
idstring

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

Example:"5b7e8b2f-7a1a-4e6c-8e1b-4f9d4f4c4d4f"
objectstring

The type of object which was deleted. - company

Value:"company"
Example:"company"
deletedboolean

Whether the company was deleted successfully or not.

Example:true
Response
{
  "id": "6657aac36abd0164c24b0cb5",
  "object": "company",
  "deleted": true
}