URL
License
The intercom API reference.
https://api.intercom.io/
https://api.eu.intercom.io/
https://api.au.intercom.io/
https://api.intercom.io/contacts/{contact_id}/companies
https://api.eu.intercom.io/contacts/{contact_id}/companies
https://api.au.intercom.io/contacts/{contact_id}/companies
curl -i -X POST \
'https://api.intercom.io/contacts/{contact_id}/companies' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-H 'Intercom-Version: 2.11' \
-d '{
"id": "667d608d8a68186f43bafd70"
}'Successful
The Intercom defined id representing the company.
The Intercom defined code of the workspace the company is associated to.
The time the company last recorded making a request.
The custom attributes you have set on the company.
{ "type": "company", "company_id": "1", "id": "667d608d8a68186f43bafd70", "app_id": "this_is_an_id166_that_should_be_at_least_", "name": "company6", "remote_created_at": 1719492749, "created_at": 1719492749, "updated_at": 1719492749, "monthly_spend": 0, "session_count": 0, "user_count": 1, "tags": { "type": "tag.list", "tags": [] }, "segments": { "type": "segment.list", "segments": [] }, "plan": {}, "custom_attributes": {} }
https://api.intercom.io/contacts/{contact_id}/companies
https://api.eu.intercom.io/contacts/{contact_id}/companies
https://api.au.intercom.io/contacts/{contact_id}/companies
curl -i -X GET \
'https://api.intercom.io/contacts/63a07ddf05a32042dffac965/companies?page=1&per_page=15' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Intercom-Version: 2.11'successful
An array containing Company Objects
The Intercom defined id representing the company.
The Intercom defined code of the workspace the company is associated to.
The time the company was created by you.
The time the company was added in Intercom.
The time the company last recorded making a request.
The URL for the company website.
How much revenue the company generates for your business.
The custom attributes you have set on the company.
The majority of list resources in the API are paginated to allow clients to traverse data over multiple requests.
Their responses are likely to contain a pages object that hosts pagination links which a client can use to paginate through the data without having to construct a query. The link relations for the pages field are as follows.
{ "type": "list", "data": [ { … } ], "pages": { "type": "pages", "next": null, "page": 1, "per_page": 50, "total_pages": 1 }, "total_count": 1 }
https://api.intercom.io/contacts/{contact_id}/companies/{company_id}
https://api.eu.intercom.io/contacts/{contact_id}/companies/{company_id}
https://api.au.intercom.io/contacts/{contact_id}/companies/{company_id}
curl -i -X DELETE \
https://api.intercom.io/contacts/58a430d35458202d41b1e65b/companies/58a430d35458202d41b1e65b \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Intercom-Version: 2.11'Successful
The Intercom defined id representing the company.
The Intercom defined code of the workspace the company is associated to.
The time the company last recorded making a request.
The custom attributes you have set on the company.
{ "type": "company", "company_id": "1", "id": "667d60918a68186f43bafd80", "app_id": "this_is_an_id174_that_should_be_at_least_", "name": "company8", "remote_created_at": 1719492753, "created_at": 1719492753, "updated_at": 1719492753, "monthly_spend": 0, "session_count": 0, "user_count": 0, "tags": { "type": "tag.list", "tags": [] }, "segments": { "type": "segment.list", "segments": [] }, "plan": {}, "custom_attributes": {} }