Remove a contact from a company

delete

https://api.customerly.io/v2/contacts/{polymorphic_contact_id}/companies/{polymorphic_company_id}

Removes the association between a contact and a company. The contact and company
themselves are not deleted, only the relationship between them is removed.

How to Identify the Contact

Use any of these identifier formats in the URL path:

Numeric ID: 12345
Custom user ID: cuid:user_123
Custom lead ID: clid:lead_456
WhatsApp: wa:+1234567890
Email: uem:[email protected] or lem:[email protected]

How to Identify the Company

Use any of these identifier formats in the URL path:

Numeric ID: 12345
Custom company ID: cid:company_abc123

Response

204 No Content: Association successfully removed (empty response body)
404 Not Found: Contact or company doesn't exist

Example Requests

# Remove contact from company using numeric IDs
DELETE /contacts/29911301/companies/12345

# Remove contact from company using custom IDs
DELETE /contacts/cuid:user_abc123/companies/cid:acme_corp

# Remove contact from company using email and custom company ID
DELETE /contacts/uem:[email protected]/companies/cid:acme_corp

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

204

Contact successfully removed from company. No content is returned in the response body.

401

Authentication credentials are missing or invalid

403

You don't have permission to modify contact-company associations

404

Contact or company not found, or the contact is not associated with this company