List Ad Platform Connections
GET/api/advertising/connections
Returns one entry per supported ad platform (amazon_ads, ebay, google_ads, walmart_connect, meta_ads, tiktok_ads), whether or not the tenant has connected it, with the platform's access level, whether a connector is available, the overall connection state, account counts and every connection (integration instance) the tenant has for it.
advertising:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Requires the advertising.view permission. Token scope: advertising:read (personal access and OAuth tokens).
state is one of not_connected, connected, needs_reauth (at least one account lost its authorization), awaiting_platform_approval (the platform has not yet approved SKU.io's API access, so it cannot be connected) or reporting_only (connected with read access only: performance is imported but no changes can be pushed). access_level is not_connected, awaiting_approval, reporting_only or full; can_write is true only for full.
Per connection: integration_instance_id, name, status (connected, needs_reauth, disconnected), accounts, selected_accounts, needs_reauth_accounts, unmapped_channel_accounts (selected accounts with no sales channel) and last_synced_at (latest performance sync).
extras holds platform-specific data and is an empty object for most platforms. For google_ads it contains ops_meters, keyed by ad account id, with the daily API operations budget (used, budget, remaining, resets_at). For ebay it contains connection_options: one entry per eBay sales channel with integration_instance_id, name, marketplace_code, marketing_scope (granted, missing, unknown), can_use_existing, action (use_existing or reconsent), ad_account_count and selected_ad_account_count. Not paginated.
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthorized
Response Headers
Forbidden
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.