Skip to main content
POST
Accept Account Suggestions

Accept Account Suggestions

Creates an account for each domain you confirm from List Account Suggestions. The account’s external ID and domain are the domain, and its name is derived from it (acme-corp.com becomes Acme Corp). Every contact at the domain that belongs to no account is added as a member.
  • When one account already uses the domain as its domain or external ID, the contacts are added to that account instead.
  • Contacts already in another account stay where they are. If no account uses the domain but some of its contacts already belong to one, the domain is skipped so the organization is not duplicated.
  • Existing roles, names and domains are kept. No sync rules run, and sequences that start when a contact enters a segment are not triggered.
  • If a call fails partway, retrying it with the same domains finishes the work.
  • Retries are safe: a repeated call adds nothing new and returns updated.
Accepting the first suggestion turns Accounts on for the workspace, with the same 409 rule as creating an account. Requires the subscribers:write scope.

Request

string[]
required
1 to 25 domains, such as acme.com. Domains are lowercased and duplicates are ignored. A personal or disposable provider, one of your own sending domains, or anything that is not a hostname rejects the whole request with 400 before anything is written.

Response

number
Accounts created by this call.
number
Memberships created by this call.
array
One entry per domain, in request order.