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

Delete a company

Request

Delete a single company.

The company record is kept in your workspace, but all contacts are detached. The contacts themselves are not deleted. Detaching contacts is permanent and can't be reversed. These changes may take some time to be reflected in your workspace.

The response returns "deleted": true as soon as the request is accepted; the contacts are detached in the background. A company.deleted webhook is sent after that work finishes, so it arrives some time after the response. No webhook is sent for a company that has no contacts attached, because there is nothing to detach.

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.

Requires the write_users_companies OAuth scope.

Security
bearerAuth
Path
company_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.
If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.

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

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

Always true. The contacts are detached after the response is sent.

Example:true
Response
{
  "id": "6762f0881bb69f9f2193bb09",
  "object": "company",
  "deleted": true
}