Facebook Pages
Facebook pages, and the Instagram business accounts linked to them.
Facebook pages, and the Instagram business accounts linked to them.
Connect accounts
Each person connects their own Facebook Pages account in the Gateway, once, and every app that asks uses it. Apps never see the tokens. How connecting works
The redirect URI to register, with your Gateway's address (like apps.example.com):
https://<your gateway>/connect/facebook/callbackA Business app with Facebook Login. Meta issues no refresh token: a person reconnects when the token expires. Not yet tried against a live connect.
- Open developers.facebook.com and create an OAuth app (also called a client or an integration).
- Add the redirect URI above.
- Copy the client ID and client secret. The secret is often shown only once.
Add it to your Gateway. It asks for the client ID and secret:
everyapp provider add facebookOr add it in Manage workspace → Providers.
Use it in an app
capabilities: {
facebook: { access: "read", scopes: ["pages.read"], why: "What the app does with it." },
},Apps ask for these scope sets:
| Set | Allows | Provider scopes |
|---|---|---|
identity | Facebook account (who you are) | public_profile |
pages.read | Pages you manage and their insights (read) | pages_show_list, pages_read_engagement, read_insights |
pages.write | Pages you manage (read, post and reply) | pages_show_list, business_management, pages_manage_posts, pages_manage_engagement, pages_read_engagement |
instagram.write | Instagram business accounts linked to your pages | pages_show_list, instagram_basic, instagram_content_publish, instagram_manage_comments, instagram_manage_insights |
Check it worked: everyapp provider show facebook shows the client as set. Then open the account menu → Connected accounts → Connect Facebook Pages.
Something wrong or missing? Open an issue.