Permissions are a form of granular, user-granted Graph API authorization. Before your app can use an endpoint to access an app user's data, the app user must grant your app all permissions required by that endpoint.
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).
email
and public_profile
if your app needs access to data that you do not own or manage
When users log onto your app, they receive a request to grant the permissions your app has requested. 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, the app user must regrant your app that permission.
You can use the app dashboard to remove a permission your app no longer uses or to remove a permission that has been deprecated.
Permission | Description |
---|---|
| 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. Allowed Usage
|
| 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
|
| 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
|
Permission | Description |
---|---|
| The instagram_basic permission allows your app to read an Instagram account profile's info and media. Allowed Usage
|
| 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. Allowed Usage
|
| 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. 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). Allowed Usage
|
| 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. 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). Allowed Usage
|
| 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
|
| 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. 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). Allowed Usage
|
| The instagram_business_manage_comments permission allows an app to access comments on an Instagram professional account, as well as public posts and Instagram Stories where that account is tagged or mentioned in comments. The allowed usage for this permission is to create, update and delete comments for an Instagram professional account. Allowed Usage
|
| 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
|
| The instagram_content_publish permission allows your app to create organic feed photo and video posts on behalf of a business user. Allowed Usage
|
| The instagram_graph_user_media permission allows your app to read the Media node, which represents an image, video, or album and the node’s edges. Allowed Usage
|
| The instagram_graph_user_profile permission allows your app to read the app user's profile. Allowed Usage
|
| 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. Allowed Usage
|
| 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. 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). Allowed Usage
|
| 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. Allowed Usage
|
| The instagram_manage_messages permission allows business users to read and respond to Instagram Direct messages. Allowed Usage
|
| The instagram_shopping_tag_products permission allows an app to tag Instagram media with product tags and appeal product rejections. Allowed Usage
|
| 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. 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). Allowed Usage
|
Permission | Description |
---|---|
| 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. Allowed Usage
|
| The pages_manage_ads permission allows your app to manage ads associated with the Page. Allowed Usage
|
| 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
|
| The pages_manage_instant_articles permission allows your app to manage Instant Articles on behalf of Facebook Pages administered by people using your app. Allowed Usage
|
| The pages_manage_engagement permission allows your app to create, edit and delete comments posted on the Page. Allowed Usage
|
| 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. Allowed Usage
|
| The pages_manage_posts permission allows your app to create, edit and delete your Page posts. Allowed Usage
|
| The pages_messaging permission allows your app to manage and access Page conversations in Messenger. Allowed Usage
|
| 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. Allowed Usage
|
| 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. Allowed Usage
|
| The pages_show_list permission allows your app to access the list of Pages a person manages. Allowed Usage
|
| The pages_user_gender permission allows your app to access a user's gender through the Page your app is connected to. Allowed Usage
|
| The pages_user_locale permission allows your app to access a user's locale through the Page your app is connected to. Allowed Usage
|
| 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
|
| The private_computation_access permission allows an app to access the Meta Private Computation products. Allowed Usage
|
| 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. Allowed Usage
|
| The publish_video permission allows your app to publish live videos to an app user's timeline, group, event or Page. Allowed Usage
|
To use certain permissions when your app goes live, your app must also be approved for additional permissions. These dependent permissions must have been approved either during the same app review submission or a in previous submission.
Permission | Dependent on |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|