Skip to main content
DELETE
Detach Contact Company

Overview

This endpoint detaches a contact from its company, leaving it with no company. In the same transaction, the contact’s conversions, touchpoints, and visit metadata are re-stamped with a null company id, so company-level reports and the Companies dataset company_id columns in the data warehouse follow immediately. There is no request body — the contact id in the path is the whole request. This call is idempotent: calling it on a contact that already has no company returns a normal 200, not an error.

Path Parameters

integer
required
The unique identifier of the contact to detach. Merged profile aliases are automatically resolved to the current canonical contact — the response’s id is the surviving contact.

Response

Success Response

integer
The unique identifier of the contact (after resolving merged-profile aliases).
null
Always null after a successful detach.

Error Response

string
Error description explaining what went wrong.

Example Requests

Status Codes

Notes

  • Rate Limit: This endpoint has a limit of 60 requests per minute per Space. See Rate Limiting for details, the same bucket as Update Contact.
  • No request body: the contact id in the path is the whole request.
  • Rows are re-stamped, not just the pivot: the contact’s conversions, touchpoints, and visit metadata are updated to a null company_id in the same transaction, so company-level reports and the data warehouse Companies dataset reflect the detach right away.
  • No-op on an already-detached contact: calling this on a contact with no company still returns 200 with company_id: null — it is not an error.
  • Merged profiles: If you pass an ID that was merged into another profile, the detach is applied to the canonical (current) profile, and the response’s id is that canonical id.
  • Behavior after a manual detach depends on company identity mode: in the default Auto mode, the tracker assigns a company to any contact that currently has none, so the contact’s next event carrying a business-email domain undoes the detach. In External ID mode, the next event carrying a company_external_id re-points the contact the same way.