Skip to main content
An account is the entity the authenticated user is operating as. Every buyer request runs in the context of one account, identified by a numeric id and carrying a role (MEMBER, ADMIN, or SUPER_ADMIN) that gates what the caller can do. A user can belong to several accounts; the account API lets you read the current context, list the accounts you can access, and switch your integration between them.

​
Account model

Full user-context responses returned by account creation and switching separate the product an account uses from its access and approval state: Accounts can form an organization/account hierarchy. An organization administrator can create Buyer or Seller accounts beneath it. Converting a standalone account first requires a separate disclosure and confirmation: contract and billing authority move to the new organization, organization administrators can manage its accounts, and detachment requires a dedicated migration. Fresh standalone conversion requests must send the confirmation as exactly true; omission or false returns 409 Conflict before the hierarchy changes. Once a matching idempotency receipt has committed that hierarchy, however, retries with the same key resume required administrator, contract, Buyer access posture, and account-view repairs even if confirmation is omitted or false. A retry cannot cancel or reverse authority that has already moved. Each account has its own registered customerDomain and membership settings. Organization membership grants management access through the hierarchy but does not create direct account membership. Separately, each user manages their own notification preferences — the set of event types and channels (email, in_app) they opt into.

​
Key concepts

​
Task reference

Set up buyer identity

Confirm whole-operator or specific-unit scope before new AdCP 3.2 provisioning

Get current account

GET /accounts/current — your current context

List accounts

GET /accounts — accounts you can access

Create account

POST /accounts/create-child — add an account under your organization

Update account domain

PATCH /accounts/:customerId/domain — set the registered domain

Delete account

DELETE /accounts/:customerId — remove an account from your organization

Get membership

GET /accounts/:customerId/membership — read access settings

Update membership

PATCH /accounts/:customerId/membership — toggle domain auto-join

Get notification preferences

GET /notification-preferences — your opt-ins

Update notification preferences

PUT /notification-preferences — replace your opt-ins