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

Detach a company from a contact

Detaches a company from a specific contact. Provide both identifiers to remove the association between that contact and company.

3 parameters
contact_idstringrequired
The unique identifier of the contact to detach the company from.
company_idstringrequired
The unique identifier of the company to detach from the contact.
Intercom-Versionstringoptional
API version to use for the request. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

3 status codes
200Returns the company object after it has been detached from the contact.
typestringoptional
Value is `company`
Allowed:company
idstringoptional
The Intercom defined id representing the company.
namestringoptional
The name of the company.
app_idstringoptional
The Intercom defined code of the workspace the company is associated to.
planobjectoptional
company_idstringoptional
The company id you have defined for the company.
remote_created_atintegeroptional
The time the company was created by you.
created_atintegeroptional
The time the company was added in Intercom.
updated_atintegeroptional
The last time the company was updated.
last_request_atintegeroptional
The time the company last recorded making a request.
sizeintegeroptional
The number of employees in the company.
websitestringoptional
The URL for the company website.
industrystringoptional
The industry that the company operates in.
monthly_spendintegeroptional
How much revenue the company generates for your business.
session_countintegeroptional
How many sessions the company has recorded.
user_countintegeroptional
The number of users in the company.
custom_attributesobjectoptional
The custom attributes you have set on the company.
tagsobjectoptional
The list of tags associated with the company
segmentsobjectoptional
The list of segments associated with the company
notesobjectoptional
The list of notes associated with the company
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 contact does not exist.

2 documented failures

  • company_not_found

    Company Not Found

  • not_found

    User 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 contact_id path parameter does not identify an existing contact. The company_id path parameter identifies the company to detach.