List ad accounts
Returns the platform ad accounts available for the given social account (e.g. Meta ad accounts, TikTok advertiser IDs, Google Ads customer IDs). 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.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
Social account ID
Filter response to a single platform ad account ID (e.g. act_123 for Meta, advertiser_id for TikTok). Returns at most one item.
Clamp the returned accounts[] length. Useful for typeahead pickers on agency tokens with hundreds of advertisers.
1 <= value <= 1000Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.ads.listAdAccounts({ query: { accountId: 'account_abc123', },});console.log(data);{
"accounts": [
{
"id": "string",
"name": "string",
"currency": "string",
"status": "string",
"timezoneName": "string",
"timezoneOffsetHoursUtc": 0
}
]
}{
"error": "Unauthorized"
}Send test webhook POST
Send a test webhook to verify your endpoint is configured correctly. The test payload includes event: "webhook.test" to distinguish it from real events.
List TikTok Business Centers GET
Returns the TikTok Business Centers (BCs) the connected `tiktokads` account can read. Each BC reports its advertiser count so callers can build agency-style pickers without re-walking `/v1/ads/accounts` per BC. TikTok-only. Solo advertisers (non-agency tokens) return an empty array.