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:

Permission	Description
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

Permission	Dependent on	Description
`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 Permission Permission Use Cases

Deprecated Permission	Permission 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

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.

Feature	Description
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:

Task	Permitted 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.