Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.alterauth.com/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Connect your users to Facebook for profile data, Page management, and social integrations via the Meta Graph API.
PropertyValue
Provider IDfacebook
CategorySocial
PKCESupported
Token refreshAutomatic
Redirect URIShown in Developer Portal

Step 1: Create a Facebook OAuth App

1

Go to the Meta for Developers portal

Navigate to developers.facebook.com/apps and sign in.
2

Create a new app

Click Create App and select the appropriate use case or app type, then fill in the details.
3

Configure OAuth redirect URIs

Under Use Cases, find Authentication and Account Creation, click Customize, then Go to Settings. Add the Alter callback URL from the Developer Portal to Valid OAuth Redirect URIs.
4

Get your credentials

Go to Settings > Basic and copy the App ID (Client ID) and App Secret (Client Secret).
Never share your App Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

1

Open the Developer Portal

Go to portal.alterauth.com and navigate to your app.
2

Add Facebook provider

Go to OAuth Providers > Add Provider > Facebook.
3

Enter credentials

  • Client ID: Paste your Facebook App ID
  • Client Secret: Paste your Facebook App Secret
4

Select scopes

Choose the scopes your app needs.
5

Save

Click Save. The provider is now active.

Available Scopes

ScopeDescription
public_profileAccess to name, picture, and other public fields
emailAccess to user’s email address
pages_show_listList Pages the user manages
pages_read_engagementRead Page content and engagement data
pages_manage_postsCreate and manage Page posts
instagram_basicRead Instagram business account data
business_managementManage business assets

Notes

  • Some permissions (e.g., pages_manage_posts) require App Review before use in production.
  • Facebook tokens expire after 60 days of inactivity. Alter Vault handles automatic long-lived token exchange.
  • See the Facebook Login documentation for more details.