Skip to content

Facebook Pages Meta app setup

Facebook Pages Meta app setup begins with the provider application. Create a Meta app for connecting Facebook Pages through your own OAuth credentials. The flow supports Pages, not personal profiles.

Callback URL

Register {{API_BASE_URL}}/v1/connect/facebook/callback in the provider’s Valid OAuth Redirect URIs. Configure the API origin for your environment and keep the callback path unchanged.

Configure Meta

  1. Create a business app in Meta for Developers and add Facebook Login for Business.
  2. Enter the callback under Valid OAuth Redirect URIs.
  3. Complete the app name, icon, website, privacy policy, data deletion instructions and terms.
  4. Assign app roles or test users during development. Request the listed permissions through App Review.
  5. Copy the Meta app ID and app secret.

Permissions and access restrictions

Use the permission identifiers listed in the table. Select a Page you administer during authorization. A personal Facebook profile cannot substitute for a Page in this connection.

Save the app before connecting an account

Open Integrations → Apps (BYOK) → New app and select Facebook. Fill the client ID and client secret fields using the credential map, then save the app record. Begin a new integration, pick that saved app, and only then choose Facebook for account authorization. Selecting the app first binds the connection to the intended credentials.

Requested permission identifiers
Permission
pages_show_list
pages_read_engagement
pages_manage_posts
pages_read_user_content
pages_manage_engagement

Request only the capabilities your product uses and complete the provider’s review requirements.

Credential field map
Provider valueBYOK field
Meta app IDclient ID
app secretclient secret

Store the secret in the app record; do not include it in a shared callback URL.

OAuth callback URL
{{API_BASE_URL}}/v1/connect/facebook/callback