Skip to main content
The v3 tool list is resolved from the active account. Start every session with get_status and keep what it returns: the account, your role, readiness, blockers and the accounts you can reach.

​
What get_status tells you

​
Switching accounts

Switch only to a customerId that get_status returned:
switch_account
Pass "home" to return to the credential’s home account. After a switch:
  1. process the notifications/tools/list_changed notification and fetch tools/list again;
  2. call get_status again to confirm which account is now active.
A person with both a buyer and a seller account (for example Wrenfield Coffee Co. · Buyer and Larkstone Media · Storefront) moves between them the same way the account selector in the app does.

​
What access does and does not mean

  • Every authenticated buyer and seller account can connect. Individual tools still need the right role and permissions.
  • Seeing a tool is not permission to use it. A write can still return FORBIDDEN for your role.
  • Organization accounts hold members and billing. They offer navigation and shared tools, not the buyer or seller catalogs.
  • A connection is not access to every advertiser. A seller relationship, an API key or a registered agent never implies access to advertisers you have not been granted.
Store the active customerId with every checkpoint your application saves, and check it again when you resume. Resuming work in the wrong account is the most common integration bug.