Accounts & connections · Connect
Selects a Facebook page. Works with Facebook accounts.
POST
https://api.pozy.ai/v1/connect/facebook/select-pageNeeds a connect tokenFacebook and Facebook and InstagramselectFacebookPage
Guides: Headless selection, Facebook
Request
Call it from your server with your API key and pass the short-lived token from the connect flow in the X-Connect-Token header. See Headless connect.
Request body
application/json, required
Free-form JSON object.
Example
curl -X POST "https://api.pozy.ai/v1/connect/facebook/select-page" \
-H "X-Connect-Token: $CONNECT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"profileId": "6a0b6573846efc28aaa9a3ff",
"userProfile": {
"id": "6bfebd43ddc270f6d2c56fc5",
"name": "Acme",
"profilePicture": "string"
}
}'const res = await fetch("https://api.pozy.ai/v1/connect/facebook/select-page", {
method: "POST",
headers: {
"X-Connect-Token": process.env.CONNECT_TOKEN!,
"Content-Type": "application/json",
},
body: JSON.stringify({
profileId: "6a0b6573846efc28aaa9a3ff",
userProfile: {
id: "6bfebd43ddc270f6d2c56fc5",
name: "Acme",
profilePicture: "string"
}
}),
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);import os
import requests
resp = requests.post(
"https://api.pozy.ai/v1/connect/facebook/select-page",
headers={"X-Connect-Token": os.environ["CONNECT_TOKEN"]},
json={
"profileId": "6a0b6573846efc28aaa9a3ff",
"userProfile": {
"id": "6bfebd43ddc270f6d2c56fc5",
"name": "Acme",
"profilePicture": "string",
},
},
timeout=30,
)
resp.raise_for_status()
print(resp.json())Response
200 on success
messagestringredirect_urlstringadsAccountIdstringaccountobject7 child fields
accountIdstringplatformstringOne of
facebook.usernamestringdisplayNamestringprofilePicturestringisActivebooleanselectedPageNamestring
accountsarray of objectfailedarray of objectidstringcodestringmessagestring
200 response
{
"message": "Hello from Pozy",
"redirect_url": "https://pozy.ai/media/example-1.jpg",
"adsAccountId": "689782c4c50e3b783a5acd69",
"account": {
"accountId": "696e0b682d0a31188e7a2ba9",
"platform": "facebook",
"username": "acme",
"displayName": "Acme",
"profilePicture": "string",
"isActive": true,
"selectedPageName": "Acme"
},
"accounts": [
{}
],
"failed": [
{
"id": "6bfebd43ddc270f6d2c56fc5",
"code": "string",
"message": "Hello from Pozy"
}
]
}Errors
Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:
| 400 | invalid_request_error | A parameter or body field is missing or invalid. param names it. |
| 401 | authentication_error | The API key is missing, revoked or expired. |
| 403 | permission_error | The key is read-only, scoped to other profiles, or has this resource group disabled. |
| 429 | rate_limit_error | Too many requests this minute. Wait for Retry-After seconds. |
Every code is listed in Errors.
More in Connect
GETGet OAuth connect URLPOSTComplete OAuth callbackGETConnect ads for a platformGETGet Shopify OAuth connect URLPOSTConnect a Shopify store with a custom-app Admin tokenGETGet Google Analytics OAuth connect URLGETList Google Analytics properties for a pending connectPOSTConnect the chosen Google Analytics propertyGETGet HubSpot OAuth connect URLGETGet WordPress.com OAuth connect URLGETGet Wix site install URLGETGet Webflow OAuth URLPOSTConnect Webflow with a site API tokenPOSTConnect self-hosted WordPress with an application passwordPATCHSet TikTok brand identityGETList Facebook pagesGETList Pages with a linked Instagram accountPOSTSelect the Page whose Instagram account to connectGETList Google Business Profile locationsPOSTSelect Google Business Profile locationGETGet a phone handoffGETGet the saved welcome screenPUTSave the welcome screenGETList your OAuth appsPOSTAdd an OAuth appGETGet an OAuth appPATCHUpdate an OAuth appDELRemove an OAuth appPOSTCheck an OAuth app's keysGETGet pending OAuth dataGETList LinkedIn orgsPOSTSelect LinkedIn orgGETList Pinterest boardsPOSTSelect Pinterest boardGETList Snapchat profilesPOSTSelect Snapchat profilePOSTConnect Bluesky accountPOSTConnect an OpenAI Ads accountPOSTConnect a Whop accountPOSTConnect WhatsApp via credentialsGETList numbers for selectionPOSTComplete number selectionPOSTConnect WhatsApp from Embedded SignupGETGet Embedded Signup SDK configPOSTConnect a Discord channelGETList Slack channels for the channel pickerPOSTConnect a Slack channelGETGenerate Telegram codePOSTConnect Telegram directlyPATCHCheck Telegram statusGETRead a Facebook Page's webhook subscriptionPOSTRe-subscribe a Facebook Page to Pozy's webhooksGETList Facebook pagesPUTUpdate Facebook pageGETList LinkedIn orgsPUTSwitch LinkedIn account typeGETList Pinterest boardsPOSTCreate Pinterest boardPUTSet default Pinterest boardGETGet a YouTube video transcriptGETList YouTube playlistsPOSTCreate YouTube playlistPUTSet default YouTube playlistGETList Google Business Profile locationsPUTUpdate Google Business Profile locationPOSTAssign Google Business Profile location to another profileGETList Reddit subredditsPUTSet default subredditGETGet subreddit rulesPOSTVote on a Reddit post or commentGETList subreddit flairsPOSTSet Reddit post flairGETAdmin-consent link for a Microsoft tenant