Skip to main content
Facebook IntegrationVersion: v3

Get Instagram accounts for page

GET/ad-publishing/facebook/page/{pageId}/instagram

Retrieve Instagram accounts linked to a specific Facebook page

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

Path Parameters

pageIdstringrequired

Facebook page identifier

Example:103456789012345

Query Parameters

locationIdstringrequired

Location identifier

Example:HChooFuiyPpVYzeJ4HMe
typestring

Integration type

Available optionsINTEGRATIONAD_MANAGER
Example:INTEGRATION

Response

application/json

Instagram accounts available as the ad identity for this page, merged from the Business Manager, the page-connected account, and the page-backed fallback. Check typeOfAccount before reading name or picture — they are not present on every entry.

  • Array items
    • idstringrequired

    Instagram account id

    Example:17841471697713882
    namestring

    Instagram handle. Absent on page-backed accounts, which Meta exposes by id only.

    Example:ad_manager_primary_insta
    picturestring

    Profile picture URL. Only populated for Business Manager accounts — page-connected entries omit it and page-backed entries never have one.

    Example:https://scontent.xx.fbcdn.net/v/t51.2885-15/...
    typeOfAccountstringrequired

    Which source the account was resolved from, and therefore which other fields to expect

    Available optionsBusiness Manager Instagram AccountPage Connected Instagram AccountPage Backed Instagram Account
    Example:Page Connected Instagram Account