Skip to content

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 ​

ScopePurposeRequired
pages_show_listView the list of Pages via the me/accounts endpointRequired
pages_read_engagementAccess to engagement metrics via fetchFacebookPageInsightsRequired

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_token for 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:

RoleAccess to statisticsAccess to management
AdminFullFull
EditorFullLimited
ModeratorLimitedLimited
AnalystFullNo

Recommended role: Admin or Editor.

Maintained by the LightLead Documentation Team · Last verified: 2026-07-25