Zernio API Docs

Appearance

Select Facebook page ​

Complete the headless flow by saving the user's selected Facebook page. Pass the userProfile from the OAuth redirect and use X-Connect-Token if connecting via API key.

POST /v1/connect/facebook/select-page ​

Complete the headless flow by saving the user's selected Facebook page. Pass the userProfile from the OAuth redirect and use X-Connect-Token if connecting via API key.

Request body ​

Content-Type: application/json

  • profileId (string) required — Profile ID from your connection flow
  • pageId (string) required — The Facebook Page ID selected by the user
  • tempToken (string) required — Temporary Facebook access token from OAuth
  • userProfile (object) required — Decoded user profile object from the OAuth callback
  • redirect_url (string) — Optional custom redirect URL to return to after selection

Example:

json

{
  "profileId": "507f1f77bcf86cd799439011",
  "pageId": "123456789",
  "tempToken": "EAAxxxxx...",
  "userProfile": {
    "id": "987654321",
    "name": "John Doe",
    "profilePicture": "https://..."
  },
  "redirect_url": "https://yourdomain.com/integrations/callback"
}

Responses ​

200 — Facebook Page connected successfully

  • message (string)
  • redirect_url (string) — Redirect URL if custom redirect_url was provided
  • account (object)

400 — Missing required fields (profileId, pageId, tempToken, or userProfile)

401

403 — User does not have access to the specified profile

404 — Selected page not found in available pages

500 — Failed to save Facebook connection