Remove a granted company from a contact (Preview)

Request

Remove a single company from a contact's granted set, leaving the contact's other grants in place.

Identify the company by the company_id you set on it, the same value GET /contacts/{contact_id}/granted_companies returns. A company_id containing a dot or a slash is supported — URL-encode a slash as %2F.

This endpoint is not idempotent. Removing a company the contact is not currently granted returns 404 with the code company_not_found, so repeating a successful call returns 404 rather than 204. Treat the first 204 as the confirmation.

Requires granted companies to be enabled

This endpoint returns 404 with the code granted_companies_not_enabled unless granted companies are enabled for the workspace. Contact Intercom Support to enable it.

Requires the write_users_companies OAuth scope. Set Intercom-Version: preview.

Security

bearerAuth

Path

contact_idstringrequired

The unique identifier for the contact which is given by Intercom

Example:63a07ddf05a32042dffac965

company_idstringrequired

The company_id you set on the company, as returned in company_ids.

Example:acme-corp

Intercom-Versionstring(intercom_version_preview)

Preview Intercom API version. Used for closed beta endpoints or other features under managed availability.

Default:"preview"

Value:"preview"

Example:preview

curl -i -X DELETE \
  https://api.intercom.io/contacts/63a07ddf05a32042dffac965/granted_companies/acme-corp \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: preview'

Responses

The grant was removed. No content is returned.

Response

No content