Connect

Select Facebook page

Complete a classic Facebook Page connection with profileId, pageId, tempToken and userProfile. Use X-Connect-Token for headless connections. The dashboard business-login picker instead sends only selectionToken and pageId to complete a Meta Ads connection. The server verifies the initiating user, profile access, current grants and connection eligibility. The profile, platform token, ad-account scope and return URL come only from the encrypted grant. Business selection requires a session or bearer authentication for the initiating user; X-Connect-Token is not accepted. It returns redirect_url with connected=metaads on success or an eligibility error redirect.

post/v1/connect/facebook/select-page

Request body

selectionTokenstring required

Encrypted dashboard business-login grant. Expires after ten minutes.

pageIdstring required

A Page ID from the granted Pages returned by listFacebookPages.

Example request

{
  "selectionToken": "ENCRYPTED_SELECTION_TOKEN"
}

Response

Facebook Page connected or business-login redirect returned.

messagestring
redirect_urlstring

Redirect URL when a custom redirect_url was provided or a business Page was selected.

Changes