provider Companies DELETE
/companies/{company_id} @utdk/intercom
/companies/{company_id} Delete a company
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.
{% admonition type="warning" %}
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.
{% /admonition %}
- Intercom-Version header
- enum: 1.0, 1.1, 1.2, 1.3…
- company_id path required
- The unique identifier for the company which is given by Intercom
- string
Try it
Authentication
Configure credentials for Intercom API
Gateway
The gateway proxies requests and injects credentials server-side. Configure credentials above, then enter your gateway URL.
Saved automatically to browser storage.
Code snippet
Updates live as you fill in the form above.
TypeScript
import intercom from '@utdk/intercom';
await intercom.deletecompany({
"Intercom-Version": "2.14"
})