Interface SyncAccountsSuccess

Type Declaration

• Optionalaccount_id?: string

  Seller-assigned account identifier. Use this in subsequent create_media_buy and other account-scoped operations when the seller's account model uses account_id references. For buyer-declared accounts, this may be echoed as the seller's internal handle, but the seller MUST continue accepting the natural-key AccountRef for subsequent calls.

• brand: BrandReference

• operator: string

  Operator domain, echoed from request

• Optionalname?: string

  Human-readable account name assigned by the seller

• action: "failed" | "created" | "updated" | "unchanged"

  Action taken for this account. created: new account provisioned. updated: existing account modified. unchanged: no changes needed. failed: could not process (see errors).

• status:
      | "active"
      | "pending_approval"
      | "rejected"
      | "payment_required"
      | "suspended"
      | "closed"

  Account status. active: ready for use. pending_approval: seller reviewing (credit, legal). rejected: seller declined the account request. payment_required: credit limit reached or funds depleted. suspended: was active, now paused. closed: was active, now terminated.

• Optionalbilling?: BillingParty

• Optionalbilling_entity?: BusinessEntity

• Optionalaccount_scope?: AccountScope

• Optionalsetup?: { url?: string; message: string; expires_at?: string }

  Setup information for pending accounts. Provides the agent (or human) with next steps to complete account activation.

  • Optionalurl?: string

    URL where the human can complete the required action (credit application, legal agreement, add funds)

  • message: string

    Human-readable description of what's needed

  • Optionalexpires_at?: string

    When this setup link expires

    Format

    date-time

• Optionalrate_card?: string

  Rate card applied to this account

• Optionalpayment_terms?: PaymentTerms

• Optionalcredit_limit?: { amount: number; currency: string }

  • amount: number

    Minimum

    0

  • currency: string

    Pattern

    ^[A-Z]{3}$

• Optionalerrors?: Error[]

  Per-account errors (only present when action is 'failed')

• Optionalwarnings?: string[]

  Non-fatal warnings about this account

• Optionalsandbox?: boolean

  Whether this is a sandbox account, echoed from the request. Only present for buyer-declared accounts.

• Optionalnotification_configs?: NotificationConfig[]

  Applied notification subscribers for this account after declarative replacement and activation-proof checks. Present on created, updated, and unchanged results when the buyer included notification_configs in the request or any persisted entries exist on the account. Entries are keyed by account-scoped subscriber_id; re-sending an existing subscriber_id replaces that subscriber's config rather than creating a duplicate. Only configs that the seller has persisted are echoed. authentication.credentials is omitted on every entry (write-only).

• Optionalauthorization?: AccountAuthorization