Connect

List Facebook pages

Changed on

Lists the Facebook Pages a user can pick from after signing in, so they can choose which Page to connect.

Classic connections require profileId and tempToken from the OAuth redirect. Use X-Connect-Token for headless connections. The dashboard business-login picker instead sends only selectionToken, an encrypted grant valid for ten minutes. This requires the initiating user and current profile access and returns only Page IDs and names. X-Connect-Token cannot authorize business selection.

get/v1/connect/facebook/select-page

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/connect/facebook/select-page
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Connect-Token

Query parameters

profileIdstring

Profile ID from your classic connection flow. Required with tempToken.

tempTokenstring

Temporary Facebook access token from the classic OAuth callback. Required with profileId unless sent in the X-Temp-Token header.

connectFlowstring

Set by the Zernio-hosted picker, whose user token stays in an httpOnly cookie. Integrators send tempToken instead.

selectionTokenstring

Encrypted dashboard business-login grant. Send alone instead of profileId and tempToken. Expires after ten minutes.

Headers

X-Temp-Tokenstring

The OAuth user token, in place of the tempToken query parameter. Prefer it: a query string is written to request logs along the way.

Response

List of Facebook Pages available for connection

truncatedboolean

True when Meta still had more Pages after the listing hit its time budget or the 10,000 Page cap, so pages is incomplete. Do not ask the user to reconnect with fewer Pages ticked: Meta replaces the Page grant on every authorization, so unticked Pages lose access.

Changes

  • 9010c1de973dRevision changes
    • info

      added the new optional header request parameter X-Temp-Token

    • info

      added the new optional query request parameter connectFlow

    • info

      added the non-success response with the status

  • 664b218652beRevision changes
    • info

      added the optional property to the response with the status