Permissions, Features, and Tasks

To access Pages API endpoints you may need a combination of the following permissions, features, or tasks.

For Pages that have been migrated to the New Page Experience, a Page access token is now required for all available endpoints with the follwing exceptions:

Permissions

Most endpoints require one or more permissions which must be granted to your app by app users. Typically this can be done through Facebook Login but can also be done through the Business Manager, if your app has been claimed by a Business.

All Page-related permissions require App Review before an app user can grant them to your app while it is in Live mode. For Business apps, which do not have app modes, permissions must be approved for Advanced access before they can be granted to your app by an app user without a role on the app itself or a role in a Business that has claimed it.

Beginning October 14, 2020, the pages_show_list permission will require App Review.


You will need to request access through App Review if:

  • Your app is requesting the pages_show_list permission for the first time.
  • Your app has not used the pages_show_list permission within the last 90 days.

If your app has previously been approved for any of the following permissions through App Review no action is required:

PermissionDescription
manage_pages Deprecated

Update your code by May 2022.

pages_messaging

The pages_messaging permission allows your app to manage and access Page conversations in Messenger. The allowed usage for this permission is to create user-initiated interactive experiences, send customer support messages or to confirm bookings or purchases and orders. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

pages_show_list

The pages_show_list permission allows your app to access the list of Pages a person manages. The allowed usage for this permission is to show a person the list of Pages they manage and verify that a person manages a Page. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

pages_manage_ads

The pages_manage_ads permission allows your app to manage ads associated with the Page. The allowed usage for this permission is to create and manage ads for the Page. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

pages_manage_cta

The pages_manage_cta permission allows your app to carry out POST and DELETE functions on endpoints used to manage call-to-action buttons on a Facebook Page. The allowed usage for this permission is to provide API access to manage call-to-action buttons on Pages that you manage. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

pages_manage_engagement

The pages_manage_engagement permission allows your app to create, edit and delete comments posted on the Page. If you have access to pages_read_user_content, you can also use pages_manage_engagement to delete comments posted by other Pages. It also allows your app to create and delete your own Page's Likes to Page content. The allowed usage for this permission is to help manage and moderate content on the Page. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

pages_manage_instant_articles

The pages_manage_instant_articles permission allows your app to manage Instant Articles on behalf of Facebook Pages administered by people using your app. The allowed usage for this permission is to create and update Instant Articles for Pages owned by the people who use your app. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

pages_manage_metadata

The pages_manage_metadata permission allows your app to subscribe and receive webhooks about activity on the Page, and to update settings on the Page. The allowed usage for this permission is to help a Page Admin administer and manage a Page. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

pages_manage_posts

The pages_manage_posts permission allows your app to create, edit and delete your Page posts. If you have access to pages_read_user_content, you can also use pages_manage_posts to delete Page posts created by a user. The allowed usage for this permission is to create and delete content on a Page. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

pages_read_engagement

The pages_read_engagement permission allows your app to read content (posts, photos, videos, events) posted by the Page, read followers data (including name, PSID), and profile picture, and read metadata and other insights about the Page. The allowed usage for this permission is to help a Page Admin administer and manage a Page. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

pages_read_user_content

The pages_read_user_content permission allows your app to read user generated content on the Page, such as posts, comments, and ratings by users or other Pages, and to delete user comments on Page posts. It also allows your app to read posts that the Page is tagged in. The allowed usage for this permission is to read user's and other Page’s content posted on the Page if you need it to help manage the Page. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).
publish_pages Deprecated

Update your code by May 2022..

Permission Dependencies

PermissionDependent onDescription

ads_management

pages_read_engagement pages_show_list

To be approved for ads_management your submission must include pages_read_engagement and pages_show_list or your app must have been approved for pages_read_engagement and pages_show_list in a previous submission.

instagram_basic

pages_read_engagement pages_show_list

To be approved for instagram_basic your submission must include pages_read_engagement and pages_show_list or your app must have been approved for pages_read_engagement and pages_show_list in a previous submission.

leads_retrieval

pages_manage_ads pages_read_engagement pages_show_list

To be approved for leads_retrieval your submission must include pages_manage_ads, pages_read_engagement and pages_show_list or your app must have been approved for pages_manage_ads, pages_read_engagement and pages_show_list in a previous submission.

manage_pages (deprecated)

pages_show_list

To be approved for manage_pages your submission must include pages_show_list or your app must have been approved for pages_show_list in a previous submission.

pages_manage_ads

pages_show_list

To be approved for pages_manage_ads your submission must include pages_show_list or your app must have been approved for pages_show_list in a previous submission

pages_manage_engagement

pages_read_user_content pages_show_list

To be approved for pages_manage_engagement your submission must include pages_read_user_content and pages_show_list or your app must have been approved for pages_read_user_content and pages_show_list in a previous submission.

pages_manage_metadata

pages_show_list

To be approved for pages_manage_metadata your submission must include pages_show_list or your app must have been approved for pages_show_list in a previous submission

pages_manage_posts

pages_read_engagement pages_show_list

To be approved for pages_manage_posts your submission must include pages_read_engagement and pages_show_list or your app must have been approved for pages_read_engagement and pages_show_list in a previous submission.

pages_messaging

pages_manage_metadata pages_show_list

To be approved for pages_messaging your submission must include pages_manage_metadata or your app must have been approved for pages_manage_metadata in a previous submission.

pages_read_engagement

pages_show_list

To be approved for pages_read_engagement your submission must include pages_show_list or your app must have been approved for pages_show_list in a previous submission

pages_read_user_content

pages_show_list

To be approved for pages_read_user_content your submission must include pages_show_list or your app must have been approved for pages_show_list in a previous submission

Permission Mapping

Deprecated PermissionPermission Use Cases

manage_pages

pages_manage_ads – Create, edit, and delete ads for your Page

pages_manage_metadata – Manage webhooks, update Page settings

pages_read_engagement – Read posts by your Page

– Read data of your Page followers
– Read metadata of your Page
– Read insights of your Page

pages_show_list – Get a list of Pages on which you can perform tasks

pages_read_user_content – Read User posts, comments, and ratings of your Page

– Delete User comments on your Page posts
– Read posts your Page is tagged in

publish_pages

pages_manage_posts – Create, edit, and delete your Page posts

– Delete User posts on your Page (pages_read_user_content needed)

pages_manage_engagement – Create, edit, and delete comments posted by your Page

– Delete comments posted by other Pages (pages_read_user_content needed)
– Create and delete likes posted by your Page

Features

Some endpoints require features which must be approved through the App Review process before your app can use them in Live mode. Refer to each endpoint's reference to determine which features it requires, if any.

FeatureDescription

Live Video API

The Live Video API feature allows an app to manage live videos to Pages, Groups and User timelines when combined with the correct matching permission.

Page Mentioning

The Page Mentioning feature allows your app mention any Facebook Page when publishing posts on the Pages managed by your app.

Page Public Content Access

The Page Public Content Access feature allows your app access to the Pages Search API and to read public data for Pages for which you lack the pages_read_engagement permission and the pages_read_user_content permission. Readable data includes business metadata, public comments and posts. The allowed usage for this feature is to provide aggregated, anonymized public content for competitive analysis and benchmarking. You may also use this feature to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

Page Public Metadata Access

The Page Public Metadata Access allows your app access to the Pages Search API and to read public data for Pages for which you lack the pages_read_engagement permission and the pages_read_user_content permission. The allowed usage for this feature is to analyze engagement with public Pages by viewing Like and follower counts, or aggregate public-facing About Page information from multiple, disparate pages. You may also use this permission to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

Tasks

Tasks allow app users to perform specific actions on Pages. When an app user interact with a Page, depending on the attempted action, we will first check if the app user has been approved for a task that permits that type of action.

You can approve individual users for the following tasks:

TaskPermitted Actions

ADVERTISE

  • Create ads
  • Create unpublished Page Posts
  • If an Instagram account is connected to the Page, create ads

ANALYZE

  • View Insights of the Page
  • View which Page admin published a post or comment

CREATE_CONTENT

  • Publish content as the Page on the Page

MANAGE

  • Assign and manage Page tasks

MODERATE

  • Respond to comments on Page posts as the Page
  • Delete comments on Page posts
  • Send messages as the Page
  • If an Instagram account is connected to the Page, publish content to Instagram from Facebook, respond to and delete comments, send Direct messages, sync business contact info, and create ads.

If a person is given Admin access to a Page in the UI, that person is able to perform all tasks on that Page.