Unique identifier for this account
Human-readable account name (e.g., 'Acme', 'Acme c/o Pinnacle')
OptionaladvertiserThe advertiser whose rates apply to this account
Optionalbilling_Optional intermediary who receives invoices on behalf of the advertiser (e.g., agency)
OptionalbrandOptionaloperatorDomain of the entity operating this account. When the brand operates directly, this is the brand's domain.
OptionalbillingWho is invoiced on this account. operator: seller invoices the operator (agency or brand buying direct). agent: agent consolidates billing. advertiser: seller invoices the advertiser directly, even when a different operator places orders on their behalf. See billing_entity for the invoiced party's business details.
Optionalbilling_Optionalrate_Identifier for the rate card applied to this account
Optionalpayment_Payment terms agreed for this account. Binding for all invoices when the account is active.
Optionalcredit_Maximum outstanding balance allowed
OptionalsetupPresent when status is 'pending_approval'. Contains next steps for completing account activation.
Optionalurl?: stringURL where the human can complete the required action (credit application, legal agreement, add funds).
Human-readable description of what's needed.
Optionalexpires_at?: stringWhen this setup link expires.
Optionalaccount_How the seller scoped this account. operator: shared across all brands for this operator. brand: shared across all operators for this brand. operator_brand: dedicated to a specific operator+brand combination. agent: the agent's default account with no brand or operator association.
Optionalgovernance_Governance agent endpoints registered on this account. Authentication credentials are write-only and not included in responses — use sync_governance to set or update credentials.
Governance agent endpoint URL. Must use HTTPS.
Optionalcategories?: string[]Governance categories this agent handles (e.g., ['budget_authority', 'strategic_alignment']). When omitted, the agent handles all categories.
OptionalsandboxWhen true, this is a sandbox account — no real platform calls, no real spend. For explicit accounts (require_operator_auth: true), sandbox accounts are pre-existing test accounts on the platform discovered via list_accounts. For implicit accounts, sandbox is part of the natural key: the same brand/operator pair can have both a production and sandbox account.
Optionalext
Account billed for this media buy. Includes advertiser, billing proxy (if any), and rate card applied.