Ad Accounts

List ad accounts

Changed on

Lists the ad accounts a connection can manage, such as Meta ad accounts, TikTok advertisers or Google Ads customers.

Returns the platform ad accounts available for the given account (e.g. Meta ad accounts, TikTok advertiser IDs, Google Ads customer IDs). Meta business-login accounts use their own system-user token. Fresh Meta discovery includes businessId and businessName from the owning Business Manager when available; cached entries gain these fields after the next discovery refresh.

For TikTok agencies: enumerates every advertiser under every Business Center the token can read (paginated server-side), then chunks the lookup against TikTok's /advertiser/info/ endpoint (which has a per-call cap of ≤100 IDs). Solo advertisers without a BC fall back to the OAuth-time advertiser_ids list. Cached for 1h on the SocialAccount; lazy-refreshed on first call after expiry.

For Google Ads: responds 429 when Google's API quota is temporarily exhausted (instead of an empty list). Retry after a delay.

For Reddit Ads (redditads): every Reddit ad account the connected Reddit user can reach, with businessId, approvalStatus (Reddit's admin_approval), timezone and type.

Every listed ad account carries selected: whether it is in the connection's ad-account selection (the ad accounts picked at connect time or in the dashboard picker, the ones Zernio syncs). On a connection without a selection every ad account is selected: true. Writes through /v1/ads endpoints to an ad account with selected: false are being restricted and will answer 403 ad_account_not_selected; add it to the selection first (dashboard picker, or GET /v1/connect/{platform}/ads with adAccountIds).

get/v1/ads/accounts

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/accounts
  • Auth: HTTP bearer

Query parameters

accountIdstring required

Account ID

adAccountIdstring

Filter response to a single platform ad account ID (e.g. act_123 for Meta, advertiser_id for TikTok). Returns at most one item.

limitinteger

Clamp the returned accounts[] length. Useful for typeahead pickers on agency tokens with hundreds of advertisers.

inScopeOnlyboolean

Google Ads only. true returns only the customers this connection accepts as adAccountId (or customerId) on the other /v1/ads endpoints, i.e. those inside its ad-account selection. Without it every customer the Google login can reach is listed, including ones selected on another connection of the same login, which those endpoints answer with a 400. Ignored on other platforms. On every platform, each item's selected flags selection membership without narrowing the list.

Response

Ad accounts

cachedAtstring date-time nullable

Google only. When this list was fetched from Google. Null when it was never served from cache. Absent on other platforms.

staleboolean

Google only. True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read. Absent on other platforms.

Changes