Skip to main content
Facebook IntegrationVersion: v3

Get Facebook pages

GET/ad-publishing/facebook/pages

Retrieve Facebook pages for the connected account. Without limit the response is an array of pages (this array response will soon be deprecated — migrate to the paginated form). When limit is provided the response is a paginated { pages, paging } envelope; pass after (from paging.next) to fetch the next batch.

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
fetchExistingstring

Fetch existing pages flag

Example:true
limitstring

Page size for a paginated fetch (fetchExisting only, max 50). When set, the response is a { pages, paging } envelope instead of an array.

Example:50
afterstring

Opaque cursor for the next batch, taken from the previous response paging.next

Example:QVFIU...

Response

application/json

An array of pages (default; will soon be deprecated — use limit to get the paginated { pages, paging } response), or a { pages, paging } envelope when limit is provided

oneOf
  • Array items
    • idstringrequired

    Facebook Page ID

    Example:1234567890
    namestringrequired

    Page name

    Example:Acme Marketing
    categorystring

    Page category

    Example:Marketing Agency
    picturestring

    Page profile picture URL

    Example:https://scontent.xx.fbcdn.net/...
    createdOnstring

    When the page was connected to the location

    Example:2026-01-15T10:00:00.000Z
    isConnectedbooleanrequired

    Whether the page is already connected to the location

    Example:false
    tosAcceptedboolean

    Whether the Facebook Lead Ads TOS is accepted for the page

    Example:true
    isDefaultboolean

    Whether this is the default connected page (only present when fetchExisting is false)

    Example:false