Meta Pages Permissions
The Meta Pages connector requires two OAuth permissions. Without them, neither the list of Pages nor their statistics can be retrieved.
Required Permissions
| Scope | Purpose | Required |
|---|---|---|
pages_show_list | View the list of Pages via the me/accounts endpoint | Required |
pages_read_engagement | Access to engagement metrics via fetchFacebookPageInsights | Required |
pages_show_list
Purpose: retrieving the list of Facebook Pages available to the user.
API endpoint: GET /me/accounts
What it provides:
- A list of Pages with their
id,name,category - An
access_tokenfor each Page - The ability to select a Page to connect
Without this permission: it's impossible to get the list of Pages — the connector won't be able to find the target Page.
pages_read_engagement
Purpose: reading Page engagement statistics.
API endpoint: GET /{page_id}/insights
What it provides:
- Reach metrics:
page_impressions,page_reach - Follower metrics:
page_fan_adds,page_fan_removes - Engagement metrics:
page_post_engagements,page_consumptions - Audience demographic data
Without this permission: only basic Page fields are available (name, category), but not metrics.
Checking Permissions
You can check your current permissions via the Facebook Access Token Debugger. Make sure both scopes are present in the list of active permissions.
Roles on the Page
To access Page statistics, the user must have one of the following roles:
| Role | Access to statistics | Access to management |
|---|---|---|
| Admin | Full | Full |
| Editor | Full | Limited |
| Moderator | Limited | Limited |
| Analyst | Full | No |
Recommended role: Admin or Editor.