Permissions are a form of granular, app user-granted Graph API authorization. Before your app can use an API endpoint to access your app user's data, your app user must grant your app all permissions required by that endpoint.
Only select permissions that your app needs to function as intended. Selecting unneeded permissions is a common reason for rejection during app review.
You may also use any permission granted to your app 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).
When your app users log onto your app, they receive a request to grant the permissions your app has requested. Your app users can grant or deny the requested permissions or any subset of them.
If your app does not use a permission for 90 days, usually due to user inactivity, your app user must regrant your app that permission.
You can use the Meta App Dashboard to remove a permission your app no longer uses or to remove a permission that has been deprecated.
Permission | Description and allowed usage | What to include in App Review submission |
---|---|---|
ads_management Dependencies pages_read_engagement pages_show_list | The ads_management permission allows your app to both read and manage the Ads account it owns, or has been granted access to, by the Ad account owner. The allowed usage for this permission is to programmatically create campaigns, manage ads or fetch Ad metrics to help their business. Additionally, it can also be used to build ad management tools to provide innovative solutions and differentiated values for advertisers. Allowed Usage
| Provide specific examples of why your app requires managing ads on behalf of other businesses. Screencast Requirements
|
ads_read Dependencies None | The ads_read permission allows your app to access the Ads Insights API to pull Ads report information for Ad accounts you own or have been granted access to by the owner or owners of other ad accounts through this permission. This permissions also grants your app access to the Server-Side API to allow advertisers to send web events from their servers directly to Facebook. Allowed Usage
| Provide specific examples of why your app requires accessing ads and related statistics on behalf of other businesses. Screencast Requirements
|
attribution_read Dependencies None | The attribution_read permission grants your app access to the Attribution API to pull attribution report data for lines of business you own or have been granted access to by the owner or owners of other lines of business. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
Permission | Description and allowed usage | What to include in App Review submission |
---|---|---|
catalog_management Dependencies business_management | The catalog_management permission allows your app to create, read, update and delete business-owned product catalogs that the user is an admin of. The allowed usage for this permission is to build commerce-related solutions for ecommerce platforms, travel platforms and dynamic ads. It can also be used to build inventory type management solutions like product inventory, hotel inventory or car inventory. Allowed Usage
| Use Case Description Screencast Requirements
|
| The commerce_account manage_orders permission allows your app to read and update commerce account orders. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
| The commerce_account_read_orders permission allows your app to read commerce account orders. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
| The commerce_account_read_reports permission allows your app to read finance reporting data to build custom tax, cash reconciliation and reimbursement reports for a commerce account. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
| The commerce_account_read_settings permission allows your app to read commerce account settings. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
| The commerce_manage_accounts permission allows your app to create and manage commerce accounts, such as an ecommerce app. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
Permission | Description and allowed usage | What to include in App Review submission |
---|---|---|
| The email permission allows your app to read a person's primary email address. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
Permission | Description and allowed usage | What to include in App Review submission |
---|---|---|
gaming_user_locale Dependencies gaming_profile | The gaming_user_locale permission allows your app to get a user's preferred language while the user plays a game on Facebook (for example, Instant Games or Cloud Gaming). The allowed usage for this permission is to display a game interface in the user's preferred language. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
Permission | Description and allowed usage | What to include in App Review submission |
---|---|---|
instagram_basic Dependencies pages_read_user_content pages_show_list | The instagram_basic permission allows your app to read an Instagram account profile's info and media. The allowed usage for this permission is to get basic metadata of an Instagram Business account profile, for example username and ID. Allowed Usage
| Use Case Description Include the specific Professional Instagram Account profile information your use case will require. Describe where this information can be found within your solution. Screencast Requirements
|
instagram_branded_content_ads_brand Dependencies instagram_basic pages_read_engagement pages_show_list | The instagram_branded_content_ads_brand permission allows an app to read Instagram posts where the app user's Instagram account is tagged as a paid partner, and an app user to read, request, and revoke permissions to run Partnership Ads. The allowed usage of this functionality is to enable a business to read Instagram posts where the account is tagged as a paid partner and manage permissions to run Partnership Ads without needing a pre-existing post. Allowed Usage
| Use Case Description Provide specific examples of why your app requires accesss to manage Instagram branded content ad campaigns and access data related to branded content ads on behalf of other businesses. Screencast Requirements
|
instagram_branded_content_brand Dependencies instagram_basic pages_read_engagement pages_show_list | The instagram_branded_content_brand permission allows your app to add, remove and view creators from a specific brand’s approved creators list. The allowed usage for this permission is to manage a specific brand’s Instagram creator content settings. Allowed Usage
| Use Case Description Provide specific examples of why your app requires access to manage Instagram branded content ad campaigns and access data related to branded content ads on behalf of other businesses. Screencast Requirements
|
instagram_branded_content_creator Dependencies instagram_basic pages_read_engagement pages_show_list | The instagram_branded_content_creator permission allows your app to read and change the boost status of a creator’s specific piece of content. The allowed usage for this permission is to manage Instagram creator content settings. Allowed Usage
| Use Case Description Provide specific examples of why your app requires accesss to manage Instagram branded content ad campaigns and access data related to branded content ads on behalf of other businesses. Screencast Requirements
|
instagram_business_basic Dependencies None | The instagram_business_basic allows your app to read an Instagram Business account profile's info and media. The allowed usage for this permission is to get basic metadata of an Instagram Business account profile, for example username and ID. Allowed Usage
| Use Case Description Provide specific examples of why your app requires the Screencast Requirements
|
instagram_business_content_publish Dependencies instagram_business_basic | The instagram_business_content_publish permission allows an app to create organic feed photo and video posts on behalf of a business user. The allowed usage of this permission is to allow an app to manage the organic content creation process for Instagram (for example, post photos and videos) on behalf of an Instagram business account. Allowed Usage
| Use Case Description Provide specific examples of why your app requires the Screencast Requirements
|
instagram_business_manage_comments Dependencies instagram_business_basic | The instagram_business_content_publish permission allows an app to create organic feed photo and video posts on behalf of a business user. The allowed usage of this permission is to allow an app to manage the organic content creation process for Instagram (for example, post photos and videos) on behalf of an Instagram business account. Allowed Usage
| Use Case Description Provide specific examples of why your app requires the Screencast Requirements
|
instagram_business_manage_messages Dependencies instagram_business_basic | The instagram_business_manage_messages permission allows an app to access messages on an Instagram professional account. The allowed usage for this permission is to view, manage and respond to messages, and to use third-party customer relationship management (CRM) tools to manage messages. Allowed Usage
| Use Case Description Screencast Requirements
|
instagram_creator_marketplace_discovery Dependencies
| The instagram_creator_marketplace_discovery permission allows your app to discover content creators on Instagram Creator Marketplace and access insights like creator bio, follower count, and account reach for Instagram businesses onboarded to the platform. The allowed usage for this permission is for Instagram businesses onboarded to the Creator Marketplace to retrieve insights data for eligible Instagram creators, like creator bio, follower count, and account reach. Allowed Usage
| Use Case Description Provide specific examples of why your app requires managing Screencast Requirements
|
instagram_creator_marketplace_messaging Dependencies None | The instagram_creator_marketplace_messaging permission allows an app to get a brand's partnership conversations and a creator’s messaging ID used for partnership messages. The allowed usage for this permission is for brands on the Instagram creator marketplace to send paid partnership messages to creators. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
instagram_content_publish Dependencies instagram_basic pages_read_engagement pages_show_list | The instagram_content_publish permission allows your app to create organic feed photo and video posts on behalf of a business user. The allowed usage for this permission is to manage your Instagram organic content creation process, for example post photos or videos to a main feed, on behalf of a business. Allowed Usage
| Use Case Description Provide specific examples of why your app requires the Screencast Requirements
|
instagram_manage_comments Dependencies instagram_basic pages_read_engagement pages_show_list | The instagram_manage_comments permission allows your app to create, delete and hide comments on behalf of the Instagram account linked to a Page. Your app can also read and respond to public media and comments that a business has been photo tagged or @mentioned in. The allowed usage for this permission is to read, update and delete comments of Instagram Business Accounts. Allowed Usage
| Use Case Description Provide specific examples of why your app requires the Screencast Requirements
|
instagram_manage_events Dependencies instagram_basic pages_read_engagement pages_show_list | The instagram_manage_events permission allows an app permission to log events (e.g., purchase, add-to-cart, leads) on behalf of Instagram accounts administered by the app’s users. The allowed usage for this permission is to log events on Instagram accounts and send this activity data to Meta for ads targeting, optimization and reporting; and to provide marketing and advertising analytics insights. Allowed Usage
| Use Case Description Provide specific examples of why your app requires the Screencast Requirements
|
instagram_manage_insights Dependencies instagram_basic pages_read_engagement pages_show_list | The instagram_manage_insights permission allows your app to get access to insights for the Instagram account linked to a Facebook Page. Your app can also discover and read the profile info and media of other business profiles. The allowed usage for this permission is to get metadata, data insights and story insights of an Instagram Business account. Allowed Usage
| Use Case Description Provide specific examples of why your app requires the Screencast Requirements
|
instagram_manage_messages Dependencies instagram_basic pages_read_engagement pages_show_list | The instagram_manage_messages permission allows business users to read and respond to Instagram Direct messages. The allowed usage for this permission is for businesses to retrieve threads and messages from its Instagram Direct inbox, manage messages with their customers or to use third-party customer relationship management (CRM) tools to manage its Instagram Direct inbox. Allowed Usage
| Use Case Description Screencast Requirements
|
instagram_shopping_tag_products Dependencies instagram_basic pages_read_engagement pages_show_list | The instagram_shopping_tag_products permission allows an app to tag Instagram media with product tags and appeal product rejections. The allowed usage for this functionality is to check eligibility for product tagging, get catalogs and products, tag media with product tags, manage existing product tags and appeal product rejections. Allowed Usage
| Use Case Description Provide specific examples of why your app requires the Screencast Requirements
|
instagram_manage_upcoming_events Dependencies instagram_basic pages_read_engagement pages_show_list | The instagram_manage_upcoming_events permission allows an app to read, create, and update upcoming events on behalf of Instagram accounts administered by people using the app. The allowed usage for this permission is to manage upcoming events on Instagram accounts administered by the people using the app. Allowed Usage
| Use Case Description Provide specific examples of why your app requires the Screencast Requirements
|
Permission | Description and allowed usage | What to include in App Review submission |
---|---|---|
leads_retrieval Dependencies Ads Management Standard Access ads_management ads_read business_management pages_manage_ads pages_read_engagement pages_show_list | The leads_retrieval permission allows your app to retrieve and read all information captured by a lead ads form associated with an ad created in Ads Manager or the Marketing API. The allowed usage for this permission is to contact people who completed your lead ad form requesting more information. This permission can also be used by advertiser authorized CRM platforms to pull the lead data on behalf of the advertisers. Allowed Usage
| Use Case Description Screencast Requirements Visit the App Review documentation for guidance. |
Permission | Description and allowed usage | What to include in App Review submission |
---|---|---|
pages_events Dependencies pages_show_list | The page_events permissions allows your app permission to log events on behalf of Facebook Pages administered by people using your app and to send those events to Facebook for ads targeting, optimization and reporting. The allowed usage for this permission is to send businesses related activities (for example purchase, add-to-cart, lead) on behalf of Pages owned by the people who use your app. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
pages_manage_ads Dependencies pages_show_list | 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, or ads that click to a business messaging surface, such as Messenger, Instagram Direct, or WhatsApp, associated with a Page. Allowed Usage
| Use Case Description Screencast Requirements
|
| 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. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
pages_manage_instant_articles Dependencies pages_show_list | 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. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
pages_manage_engagement Dependencies pages_read_user_content pages_show_list | The pages_manage_engagement permission allows your app to create, edit and delete comments posted on the Page. The allowed usage for this permission is to help manage and moderate content on the Page. Allowed Usage
| Use Case Description Screencast Requirements
|
pages_manage_metadata Dependencies pages_show_list | 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. Allowed Usage
| Use Case Description Screencast Requirements
|
pages_manage_posts Dependencies pages_read_engagement pages_show_list | The pages_manage_posts permission allows your app to create, edit and delete your Page posts. The allowed usage for this permission is to create and delete content on a Page. Allowed Usage
| Use Case Description Screencast Requirements
|
pages_messaging Dependencies pages_manage_metadata pages_show_list | 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. Allowed Usage
| Use Case Description Screencast Requirements
|
pages_read_engagement Dependencies pages_show_list | 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. Allowed Usage
| Use Case Description Screencast Requirements
|
pages_read_user_content Dependencies pages_show_list | 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. 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. Allowed Usage
| Use Case Description Screencast Requirements
|
pages_show_list Dependencies None | 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. Allowed Usage
| Use Case Description Provide specific examples of why your app needs to access the list of pages that a user owns. If the Screencast Requirements
|
| The pages_user_gender permission allows your app to access a user's gender through the Page your app is connected to. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
| The pages_user_locale permission allows your app to access a user's locale through the Page your app is connected to. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
| The pages_user_timezone permission grants your app access to a user's time zone through the Page your app is connected to. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
| The pages_utility_messaging permission allows an app to access a Page's utility messaging templates. The allowed usage for this permission is to manage a Page's utility messaging templates and send a Page's utility messages through Messenger. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
public_profile Dependencies None | The public_profile permission allows an app to read the Default Public Profile Fields on the User node. This permission is automatically granted to all apps. The allowed usage for this permission is to authenticate app users and provide them with a personalized in-app experience. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
publish_video Dependencies None | The publish_video permission allows your app to publish live videos to an app user's timeline, group, event or Page. The allowed usage for this permission is to live-video stream to an app user's timeline, event or Page. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
Permission | Description and allowed usage | What to include in App Review submission |
---|---|---|
read_audience_network_insights Dependencies None | The read_audience_network_insights permission allows an app to access the Audience Network insights data and pull performance report information for properties you own. The allowed usage for this permission is to integrate Audience Network properties performance data into app owner’s data analytics and dashboards. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
Dependencies pages_read_engagement pages_show_list | The read_insights permission allows your app to read the Insights data for Pages, apps and web domains the person owns. Allowed Usage
| Use Case Description Screencast Requirements
|
Permission | Description and allowed usage | What to include in App Review submission |
---|---|---|
whatsapp_business_manage_events Dependencies whatsapp_business_management | The whatsapp_business_manage_events permission allows an app to log events, such as purchase, add-to-cart, leads and more, on behalf of a WhatsApp Business Account administered by an app user. The allowed usage for this permission is to log events on WhatsApp Business Accounts and send this activity data to Meta for ads targeting, optimization and reporting. Allowed Usage
| Use Case Description Visit the App Review documentation for guidance. Screencast Requirements Visit the App Review documentation for guidance. |
whatsapp_business_management Dependencies None | The whatsapp_business_management permission allows your app to read and/or manage WhatsApp business assets you own or have been granted access to by other businesses through this permission. These business assets include WhatsApp Business Accounts, business phone numbers, message templates, QR codes and their associated messages, and webhook subscriptions. The allowed usage for this permission is to manage WhatsApp business assets and display WhatsApp Business Account analytics in your customer portal. Allowed Usage
| Use Case Description Screencast Requirements
|
whatsapp_business_messaging Dependencies whatsapp_business_management | The whatsapp_business_messaging permission allows an app to send WhatsApp messages to a specific phone number, upload and retrieve media from messages, manage and get WhatsApp business profile information, and to register those phone numbers with Meta. The allowed usage for this permission is to create messaging experiences initiated by a customer or a business. Allowed Usage
| Use Case Description Explain the messaging functionality your app offers to business customers who you have onboarded onto the platform, and how they perform those functions. Screencast Requirements
|