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.

Authorization

AuthorizationBearer <token>

API key authentication - use your Late API key as a Bearer token

In: header

Request Body

profileIdstring

Profile ID from your connection flow

pageIdstring

The Facebook Page ID selected by the user

tempTokenstring

Temporary Facebook access token from OAuth

userProfile?

Decoded user profile object from the OAuth callback

redirect_url?string

Optional custom redirect URL to return to after selection

Formaturi

Response Body

application/json

curl -X POST "https://getlate.dev/api/v1/connect/facebook/select-page" \  -H "Content-Type: application/json" \  -d '{    "profileId": "507f1f77bcf86cd799439011",    "pageId": "123456789",    "tempToken": "EAAxxxxx...",    "userProfile": {      "id": "987654321",      "name": "John Doe",      "profilePicture": "https://..."    },    "redirect_url": "https://yourdomain.com/integrations/callback"  }'

{
  "message": "Facebook page connected successfully",
  "redirect_url": "https://yourdomain.com/integrations/callback?connected=facebook&profileId=507f1f77bcf86cd799439011&username=My+Brand+Page",
  "account": {
    "accountId": "64e1f0a9e2b5af0012ab34cd",
    "platform": "facebook",
    "username": "mybrand",
    "displayName": "My Brand Page",
    "profilePicture": "https://...",
    "isActive": true,
    "selectedPageName": "My Brand Page"
  }
}

Empty

{
  "error": "Unauthorized"
}

Empty

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.

Authorization

AuthorizationBearer <token>

API key authentication - use your Late API key as a Bearer token

In: header

Request Body

profileIdstring

Profile ID from your connection flow

pageIdstring

The Facebook Page ID selected by the user

tempTokenstring

Temporary Facebook access token from OAuth

userProfile?

Decoded user profile object from the OAuth callback

redirect_url?string

Optional custom redirect URL to return to after selection

Formaturi

Response Body

application/json

curl -X POST "https://getlate.dev/api/v1/connect/facebook/select-page" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "507f1f77bcf86cd799439011",
    "pageId": "123456789",
    "tempToken": "EAAxxxxx...",
    "userProfile": {
      "id": "987654321",
      "name": "John Doe",
      "profilePicture": "https://..."
    },
    "redirect_url": "https://yourdomain.com/integrations/callback"
  }'

curl -X POST "https://getlate.dev/api/v1/connect/facebook/select-page" \  -H "Content-Type: application/json" \  -d '{    "profileId": "507f1f77bcf86cd799439011",    "pageId": "123456789",    "tempToken": "EAAxxxxx...",    "userProfile": {      "id": "987654321",      "name": "John Doe",      "profilePicture": "https://..."    },    "redirect_url": "https://yourdomain.com/integrations/callback"  }'

{
  "message": "Facebook page connected successfully",
  "redirect_url": "https://yourdomain.com/integrations/callback?connected=facebook&profileId=507f1f77bcf86cd799439011&username=My+Brand+Page",
  "account": {
    "accountId": "64e1f0a9e2b5af0012ab34cd",
    "platform": "facebook",
    "username": "mybrand",
    "displayName": "My Brand Page",
    "profilePicture": "https://...",
    "isActive": true,
    "selectedPageName": "My Brand Page"
  }
}

Empty

{
  "error": "Unauthorized"
}

Empty

Select Facebook page

Authorization

Request Body

Response Body

200application/json

400

401application/json

403

404

500

Select Facebook page

Authorization

Request Body

Response Body

200application/json

400

401application/json

403

404

500

application/json

application/json

application/json

application/json