Skip to main content
Facebook IntegrationVersion: v3

Get ad accounts

GET/ad-publishing/facebook/ad-accounts

Retrieve Facebook ad accounts available for the connected user

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Query Parameters

locationIdstringrequired

Location identifier

Example:loc_abc123
typestring

Account source type

Available optionsINTEGRATIONAD_MANAGER
Example:AD_MANAGER
nextstring

Pagination cursor

Example:cursor_abc
fetchAllstring

Fetch all accounts

Example:true
limitstring

Results page limit

Example:25

Response

application/json

Ad accounts the connected user can access

  • Array items
    • idstringrequired

    Ad account id, prefixed with act_

    Example:act_357046700569338
    namestringrequired

    Ad account name

    Example:Acme - Production
    accountStatusstringrequired

    Account status. UNKNOWN when Facebook returns a code the service does not map.

    Available optionsACTIVEDISABLEDUNSETTLEDPENDING_RISK_REVIEWPENDING_SETTLEMENTIN_GRACE_PERIODPENDING_CLOSURECLOSEDANY_ACTIVEANY_CLOSEDUNKNOWN
    Example:ACTIVE
    currencystringrequired

    Account billing currency, ISO 4217

    Example:USD
    fundingTypestringrequired

    How the account is funded. NONE when no funding source is set.

    Example:FACEBOOK_EXTENDED_CREDIT
    businessobject

    Owning Business Manager. Absent for personal ad accounts that belong to no business.

    integrationConnectedbooleanrequired

    True when this account is the one currently connected to the location

    Example:false