Skip to main content
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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
domain
string
required

Email domain used to create the new account.

Minimum string length: 1
contact_ids
string[]
required

IDs of existing contacts to link to the newly created account.

account_name
string
required

Name for the new account created from this domain.

Minimum string length: 1

Response

Successful Response

The response is of type Response Promote Contact Route Contacts Promote Post · object.