Promote Contact
Contacts
Bulk-Promote Contacts by Domain
POST
Promote Contact
Creates one new account from a domain and links a batch of existing contacts to it in one call — e.g. promoting a cluster of same-company targets/leads once you know the company. Account creation is attempted first; if it fails, the request raises before any contact is touched, so contacts are never left linked to a dangling account. Contact-linking itself is not transactional — see the response shape below for how partial failure surfaces.
Auth
Requires a CRM manage scope and an active organization on the token. Any*:manage scope qualifies — in practice contacts:manage, deals:manage, companies:manage, or activities:manage.
Response
Errors
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Response
Successful Response
The response is of type Response Promote Contact Route Contacts Promote Post · object.