SocialOAuth 2.0 (Facebook Login) — App ID + App secretPricing verified 2026-10-06
Facebook / Meta
Publish to Facebook Pages and Instagram professional accounts, sync comments, Messenger and Instagram DMs, page reviews and Lead Ads; also the base app for Meta Ads.
AProvider definition
- Provider
- Facebook / Meta
- What it does
- Publish to Facebook Pages and Instagram Business accounts, sync comments, Messenger and Instagram DMs, and page reviews.
- Why we need it
- Publish to Facebook Pages and Instagram professional accounts, sync comments, Messenger and Instagram DMs, page reviews and Lead Ads; also the base app for Meta Ads.
- Used in
- Social (publish, comments, inbox, reviews) · CRM (Lead Ads, DMs) · Performance ads (Meta Ads)
- Official site
- https://developers.facebook.com/apps
BAccount requirements
- Account type
- Meta developer account + a Business-type Meta app
- Prerequisites
- Facebook account with admin rights on the Pages
- Meta Business Portfolio (Business Manager)
- Instagram professional account linked to a Page (for Instagram)
- Verification
- Business Verification is required for Advanced Access to any permission.
CConnection method
- Authentication
- OAuth 2.0 (Facebook Login) — App ID + App secret
- Where to enter it
- Your workspace: App → Integrations → Providers & API keysWorkspace owner or admin. Keys added here are used only by your workspace (AI keys here don't use plan credits).
- Per brand: App → Integrations → Connected accountsAnyone who manages the brand. Each brand connects its own accounts.
Setup steps
- 1Go to developers.facebook.com → My Apps → Create app → choose the Business type.
- 2Add the products: Facebook Login for Business, Instagram (API with Facebook Login), Messenger, Webhooks, and Marketing API if you use Meta Ads.
- 3Facebook Login → Settings: add the Valid OAuth redirect URIs shown below.
- 4Webhooks: subscribe the Page and Instagram objects to the callback URL shown below, using the verify token you enter in the application.
- 5App settings → Basic: copy the App ID and App secret; add privacy policy and terms URLs, app icon and category.
- 6App Review → Permissions and features: request Advanced Access for each permission listed below, with a screencast of how the app uses it.
- 7Complete Business Verification for your Business Portfolio.
- 8Switch the app to Live mode, enter the App ID and secret in the application, then connect each brand from Integrations → Connected accounts.
DPermissions & API scopes
| Scope / permission | Why it's needed | Requested by |
|---|---|---|
| pages_show_list | List the Pages you manage so you can pick which to connect. | Facebook & Instagram connection |
| pages_read_engagement | Read Page posts, followers and engagement for analytics. | Facebook & Instagram connection |
| pages_manage_posts | Publish, schedule and delete posts on your Pages. | Facebook & Instagram connection |
| pages_manage_engagement | Reply to and moderate comments. | Facebook & Instagram connection |
| pages_read_user_content | Read comments and posts by others on your Pages. | Facebook & Instagram connection |
| pages_manage_metadata | Subscribe your Page to webhooks for real-time comments and messages. | Facebook & Instagram connection |
| pages_messaging | Read and reply to Messenger conversations in the inbox. | Facebook & Instagram connection |
| read_insights | Read Page insights for analytics and reports. | Facebook & Instagram connection |
| business_management | Access Pages and assets owned by your Business Portfolio. | Facebook & Instagram connection |
| leads_retrieval | Import Facebook/Instagram Lead Ads submissions into the CRM. | Facebook & Instagram connection |
| pages_manage_ads | Manage Lead Ads forms connected to the Page. | Facebook & Instagram connection |
| instagram_basic | Read the connected Instagram professional account profile and media. | Facebook & Instagram connection |
| instagram_content_publish | Publish photos, carousels and reels to Instagram. | Facebook & Instagram connection |
| instagram_manage_comments | Read and reply to Instagram comments. | Facebook & Instagram connection |
| instagram_manage_messages | Read and reply to Instagram DMs in the inbox. | Facebook & Instagram connection |
| instagram_manage_insights | Read Instagram post and account insights. | Facebook & Instagram connection |
| ads_management | (Meta Ads) Create, pause and change budgets of campaigns. | Meta Ads connection |
| ads_read | (Meta Ads) Read campaign spend and results. | Meta Ads connection |
| business_management | Access Pages and assets owned by your Business Portfolio. | Meta Ads connection |
| pages_show_list | List the Pages you manage so you can pick which to connect. | Meta Ads connection |
| pages_read_engagement | Read Page posts, followers and engagement for analytics. | Meta Ads connection |
| leads_retrieval | Import Facebook/Instagram Lead Ads submissions into the CRM. | Meta Ads connection |
| pages_manage_ads | Manage Lead Ads forms connected to the Page. | Meta Ads connection |
This list is generated from the scopes the application's code requests.
EFree vs paid
- Free account / free API access
- Yes — the Graph API has no subscription fee.
- Card or billing account required?
- No for the API itself. Ad spend is billed by Meta in Ads Manager.
- Paid plan / costs
- None for API access.
- Quota and usage limits
- Rate limits per app and per Page (Business Use Case limits); Instagram allows a limited number of API-published posts per account per 24 hours.
- Production restrictions
- Until App Review grants Advanced Access, only people with a role on the app (admins, developers, testers) can connect. App Review typically takes days to weeks per submission.
Checked against official/current sources on 2026-10-06. Provider pricing changes often — re-check before publishing.
FSetup screenshots
Capture each step with real values masked. Save images as public/docs/integrations/meta/1.png … 10.png and they appear here automatically.
- Screenshot to add1. Account login / creationThe provider's sign-in or sign-up page.
- Screenshot to add2. Developer consoleThe developer console or dashboard home.
- Screenshot to add3. Project / app creationCreating the app or project used for this integration.
- Screenshot to add4. API enablementThe API or product enabled for the project.
- Screenshot to add5. OAuth configurationConsent screen / OAuth settings with the redirect URIs.
- Screenshot to add6. API key / credentials creationCreating the key, secret or token (mask the value).
- Screenshot to add7. Permissions / scopesThe scopes or permissions requested or approved.
- Screenshot to add8. Billing / quota settingsBilling, credits or quota page.
- Screenshot to add9. Application connectionThe provider card in our application with fields filled (secrets masked).
- Screenshot to add10. Successful connectionThe green Test result or the connected account listed.
GApplication configuration
Never include real API keys, client secrets, access tokens or passwords in screenshots, tickets or documentation. Values below are field names and examples only.
| Field | Required | Example / default | Notes |
|---|---|---|---|
| App ID | Yes | — | |
| App secret | Yes | •••••••• | Stored encrypted; shown masked after saving. |
| Graph API version | Optional | v26.0 | |
| Webhook verify token | Optional | — | Any random string; paste the same value in the Meta webhook settings. |
Paste these into the provider's console
- Valid OAuth redirect URI
https://api.socialmati.com/api/oauth/meta/callback- Webhook callback URL
https://api.socialmati.com/api/webhooks/meta- Valid OAuth redirect URI (Ads Manager)
https://api.socialmati.com/api/oauth/ads/meta/callback
Connecting an ad account (Meta Ads)
Covers Facebook, Instagram, Messenger, Audience Network. Connect with OAuth from Performance ads → Ad accounts, or paste a token:
- • Access token (system user recommended) (required)
- • Ad account ID (required) — Digits only, without act_
HTesting
- 1Integrations → Connected accounts → Connect Facebook; approve the Pages.
- 2Social → Create post → publish a test post to one Page.
- 3Comment on that post from another account — it should appear in Social → Comments within a minute.
ITroubleshooting
| Problem | What to do |
|---|---|
| “URL blocked” / redirect_uri mismatch | The redirect URI must match exactly (https, path, no trailing slash) in Facebook Login → Settings. |
| Only your own account can connect | The app is in Development mode or lacks Advanced Access. Complete App Review and switch to Live. |
| (#200) permission error when publishing | The permission was not granted or not approved. Reconnect and accept all permissions; check App Review status. |
| Instagram account not listed | It must be a Business or Creator account linked to a Facebook Page you manage. |
| Token expired | Page tokens become invalid when the user changes password or removes the app. Reconnect the account. |
| Invalid credentials | Check the Client ID/App ID and secret were copied from the same app, without spaces. Regenerate the secret if unsure. |
| Missing permissions | Reconnect and accept every permission on the consent screen. If a permission is missing from the list, add it to the app (and get it approved). |
| OAuth failure | Sign-in was cancelled, the app is in development/testing mode, or the user isn't allowed to use it yet. Add the user as a tester or publish the app. |
| Redirect URI mismatch | Copy the redirect URI from section G exactly — same https scheme, host and path, no trailing slash — into the provider's app settings. |
| API not enabled | Enable the API/product for the project or app in the provider console and wait a few minutes. |
| Quota exceeded | Wait for the quota window to reset (see section E) or request a higher quota / add credits. |
| Account not eligible | Check the account requirements in section B (e.g. business/professional account, verified property, registered organisation). |
| App review required | Permissions beyond development access need the provider's review before other accounts can connect. See section E for restrictions. |
| Billing required | Add a payment method or prepaid credits on the provider account (see section E). |
JDisconnect & security
- Revoke access at the provider
- Facebook → Settings & privacy → Business integrations → remove the app; or disconnect in Integrations → Connected accounts. Reset the App secret in App settings → Basic to rotate it.
- Disconnect in the application
- App → Integrations → Providers & API keys or App → Integrations → Connected accounts → open the card → Remove / Disconnect. Connected accounts can be disconnected per brand.
- Rotate credentials
- Create the new key or secret first, paste it into the same card and Test, then delete the old one at the provider — no downtime.
- How credentials are stored
- Encrypted at rest with AES-256-GCM using the server's ENCRYPTION_KEY, shown masked after saving, never returned to the browser, and used only from the API server.
- What data the application can access
- Pages and Instagram accounts you approve: posts, comments, messages, insights, reviews and lead form submissions.
Other Social providers
Instagram
OAuth 2.0 through the Meta app (Facebook Login)
Setup guide Threads
OAuth 2.0 — Threads app ID + secret
Setup guide LinkedIn
OAuth 2.0 — Client ID + Client secret
Setup guide X (Twitter)
OAuth 2.0 with PKCE — Client ID + Client secret (+ app bearer token for listening)
Setup guide YouTube
OAuth 2.0 (Google) + optional API key
Setup guide TikTok
OAuth 2.0 — Client key + Client secret
Setup guide 
