Permissions Reference

When a person logs into your app via Facebook Login, you can access a subset of that person's data stored on Facebook. Permissions are how you ask someone if you can access that data. A person's privacy settings combined with what you ask for will determine what you can access.

For more information about permissions, see Permissions with Facebook Login.

Every permission below requires App Review, except: email, pages_show_list.

A

PermissionDescription
ads_management 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. 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).
ads_read
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. The allowed usage for this permission is to provide API access to your ad performance data for use in custom dashboards and data analytics, or to send web events from your server directly to Facebook. 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).
attribution_read
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. The allowed usage for this permission is to provide the ability for your app to access ads performance data from attribution for use in custom dashboards and data analytics. Note: Requires the ads_read and business_management permissions to work correctly. 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).

B

PermissionDescription
business_management
The business_management permission allows your app to read and write with the Business Manager API. The allowed usage for this permission is to manage business assets such as an ad account and to claim ad accounts. 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).

C

PermissionDescription
catalog_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. 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).

E

Permission Description
email The email permission allows your app to read an person's primary email address. The allowed usage for this permission is to let end users log into your app with the email address associated with their Facebook profile. 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). This permission is automatically granted to all apps.

G

Permission Description
groups_access_member_info
The groups_access_member_info permission allows your app to read publicly available group member information like name and ID if the post author has granted your app access. The allowed usage for this permission is to add user details to content posted in their group and help group admins to collect insights about activity happening in their group. 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).

I


Permission Description
instagram_basic
The instagram_basic 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. 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).
instagram_manage_comments 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, or to read media objects, such as Stories, of Instagram Business Accounts. 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).
instagram_manage_insights
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. 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).

L

PermissionDescription
leads_retrieval 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. For example, an auto dealer reaching out to a potential customer (lead) that responded to their ad with quotes for a car. This permission can also be used by advertiser authorized CRM platforms to pull the lead data on behalf of the advertisers. These advertisers can then use the lead information to reach out to the user. Note: Requires the manage_pages permission to work correctly. 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).

P

PermissionDescription
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_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. You can use this permission 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_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_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_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_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).
pages_show_list The pages_show_list permission allows your app to show the list of the Pages that a person manages. You can use this permission to provide API access to accounts for showing the list of the Pages that a person manages. 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_user_gender
The pages_user_gender permission allows your app to access a user's gender through the Page your app is connected to. The allowed usage for this permission is to personalize the experience of people interacting with your Messenger integration. 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_user_locale
The pages_user_locale permission allows your app to access a user's locale through the Page your app is connected to. You can use this permission to personalize the experience of people interacting with your Messenger integration. 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_user_timezone
The pages_user_timezone permission grants your app access to a user's time zone through the Page your app is connected to. You can use this permission to personalize the experience of people interacting with your Messenger integration. 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_to_groups
The publish_to_groups permission allows your app to post content into a Group on behalf of a person if they’ve granted your app access. The allowed usage for this permission is to allow people to publish content from your app to their Facebook group or to help people manage the content published to their group. 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_video
The publish_video permission allows your app to publish live videos to an app user's timeline. The allowed usage for this permission is to live-video stream to an end user's timeline. 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).

R

PermissionDescription
read_insights
The read_insights permission allows your app to read the Insights data for Pages, apps and web domains the person owns. The allowed usage for this permission is to integrate these Facebook insights into your own analytics tools. 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).

U

PermissionDescription
user_age_range
The user_age_range permission allows your app to access a person's age range as listed in their Facebook profile. The allowed usage for this permission for apps that are legally required to be age-gated and if that app contains content not suitable for the general Facebook user base, for example dating, violent or mature content. 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).
user_birthday
The user_birthday permission allows your app to read a person's birthday as listed in their Facebook profile. The allowed usage for this permission is to provide age-relevant content to people when their age range is not sufficient. 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).
user_friends
The user_friends permission allows your app to get a list of a person's friends using that app. The allowed usage for this permission is to provide Facebook-related content to personalize a person's experience. 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).
user_gender
The user_gender permission allows your app to read a person's gender as listed in their Facebook profile. The allowed usage for this permission is to render pronouns and to personalize a person's experience based on gender, for example dating, shopping and fashion apps. 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).
user_hometown
The user_hometown permission allows your app to read a person's hometown location from their Facebook profile. The allowed usage for this permission is to provide a personalized experience based on where a person lived or grew up. 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).
user_likes
The user_likes permission allows your app to read a list of all Facebook Pages that a user has Liked. The allowed usage for this permission is to provide a personalized experience by correlating or surfacing content related to the person's Likes. This includes curating content at scale to customize apps with large amounts of content, and enabling people to share their Likes with others, for example in dating and music apps. 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).
user_link
The user_link permission allows your app to access the Facebook profile URL of the person using your app. The allowed usage for this permission is to provide a way for someone who uses your app to visit that person's Facebook profile. 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).
user_photos
The user_photos permission allows your app to read the photos a person has uploaded to Facebook. The allowed usage for this permission is to create physical or digital books or albums of a person's photos, which includes permitting people to export photos for printing. This permission can also be used to provide people with the ability to display their photos with other app users, for example in dating or social apps. It can also be used to provide people with the ability to edit or create new photo content based on existing photos. 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).
user_posts
The user_posts permission allows your app to access the posts a person has made on their timeline, but not the comments on those posts. The allowed usage for this permission is to enable people to create physical or digital books or albums of their timelines, to share memories from their timeline on Facebook (or on other social apps) or to share their posts with other social apps. 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).
user_videos
The user_videos permission allows your app to read a list of videos uploaded by a person. The allowed usage for this permission is to display a person's videos on a TV via a set-top box or in a digital photo frame. Additionally, this permission can be used to provide people with the ability to edit or create new video content using existing videos. It can also be used to provide people with the ability to display their video with owners within their app, for example in dating or social apps. 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).

W

PermissionDescription
whatsapp_business_management
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, phone numbers and message templates. The allowed usage for this permission is to display WhatsApp Business Account analytics in your customer portal or to manage message templates for WhatsApp Business Accounts. 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).