Synup
Create a key
v1Resources/Connections/getList ad accounts

List ad accounts

Returns the paid-social ad accounts available on one connected account (Facebook, Instagram, LinkedIn, or TikTok).

get/api/v1/connections/ad-accounts
connections:read
Query parameters
connectionIdstringrequired
The connected account to look up. Required. Look it up with GET /api/v1/connections.
Response
dataobjectoptional
adAccountsarray of objectoptional
The ad accounts available on this connected account.
idstringoptional
Unique identifier for the ad account.
connectionIdstringoptional
ID of the connected account this ad account belongs to.
platformAccountIdstringoptional
The platform's own identifier for this ad account, e.g. act_226123609900306 for Meta.
namestringoptional
Display name of the ad account.
platformstringoptional
Platform this ad account belongs to: facebook, instagram, linkedin, or tiktok.
statusstring (active | disabled | unsettled | pending_review)optional
Platform-reported status: active, disabled, unsettled, or pending_review.
isSelectedbooleanoptional
Whether this is the ad account currently selected for boosting on this connection.
currencystringoptional
Currency this ad account bills in, or null.
archivedbooleanoptional
Whether this ad account has been archived.
createdAtstringoptional
When this ad account was first synced, as an ISO 8601 timestamp.
updatedAtstringoptional
When this ad account was last synced, as an ISO 8601 timestamp.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/connections/ad-accounts
Your API key
connectionId *
{
  "data": {
    "adAccounts": [
      {
        "id": "adacct_1",
        "connectionId": "conn_1",
        "platformAccountId": "act_549988676430053",
        "name": "Acme Dental Ads",
        "platform": "facebook",
        "status": "active",
        "isSelected": true,
        "currency": "USD",
        "archived": false,
        "createdAt": "2026-01-15T10:00:00.000Z",
        "updatedAt": "2026-01-15T10:00:00.000Z"
      }
    ]
  }
}