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