v7

latestOpenAPI 3.1.02026-08-0776170186.5 KB

accounts

Upsert Account

Create an account, or return the matching one if it already exists.

The account is matched inside your organization on domain (normalized), so re-sending the same company is safe and returns the same id. name is only used when the account (and its company) does not exist yet. 201 is returned for both the create and the match.

Upserting a contact with company_domain (POST /v1/contacts) creates the account implicitly — use this endpoint when you want to push companies before knowing which people to pursue.

Requires the accounts:write scope on the API key.

post/v1/accounts

Request body

namestring nullable

Company name. Only used when the account is created.

domainstring required

Primary company domain. The account is matched inside your organization on this domain.

Response

Successful Response

idstring uuid required

Unique identifier of the account.

namestring nullable

Company name.

domainstring nullable

Primary company domain.

owner_user_idstring uuid nullable

User who owns this account, if any.

first_seen_atstring date-time required

When this account was first associated with the organization.

last_seen_atstring date-time required

When this account was last touched in the organization.