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.

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. You can use this permission 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/or differentiated values for advertisers.
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. You can use this permission 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.
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. You can use this permission to provide the ability for your app to access ad performance data from attribution for use in custom dashboards and data analytics. Note: Requires the ads_read and business_management permissions to work correctly.

B

PermissionDescription
business_management The business_management permission allows your app to read and write with the Business Manager API. You can use this permission to manage business assets such as an ad account and to claim ad accounts.

E

Permission Description
email The email permission allows your app to read an end user's primary email address. You can use this permission to let end users log into your app with the email address associated with their Facebook profile. 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. You can use this permission to add user details to content posted in their group and help group admins to collect insights about activity happening in their group.

I

Permission Description
instagram_basic The instagram_basic permission allows your app to read an Instagram Account profile's info and media. You can use this permission to get basic metadata of an Instagram Business Account like username and ID.
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 the Page. Your app can also read and respond to public media and comments that a business has been photo tagged or @mentioned in. You can use this permission to read, update and delete comments of Instagram Business Accounts, or to read media objects, such as stories, of Instagram Business Accounts.
instagram_manage_insights The instagram_manage_insights permission allows your app to get access to insights for the Instagram account linked to the Facebook Page. You app can also discover and read the profile info and media of other business profiles. You can use this permission to get metadata, data insights and story insights of an Instagram Business Account.

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. You can use this permission to reach out to the people who followed up 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.

M

PermissionDescription
manage_pages

Deprecated for v7.0+.

The manage_pages permission allows your app to retrieve Page Access Tokens for the Pages and apps that the app user administers. You can use this permission to help people analyze or manage the posts, comments or likes that are published to their Pages. You can also use this permission to publish content to Pages owned by the people who use your app.

P

PermissionDescription
pages_manage_ads The pages_manage_ads permission allows your app the ability to manage ads associated with the Page. You can use this permission to create and manage ads for the Page.
pages_manage_cta The pages_manage_cta permission allows your app to carry out POST and DELETE functions on endpoints used to manage a Facebook Page's call-to-action buttons. You can use this permissions to provide API access to manage call-to-action buttons on Pages that you manage.
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.
pages_manage_engagement The pages_manage_engagement permission allows your app the ability 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 the ability to create and delete your own Page's likes to Page content. You can use this permission if you need it to help manage and moderate content on the Page.
pages_manage_metadata The pages_manage_metadata permission allows you to subscribe and receive webhooks about activity on the Page, and to update settings on the Page. You can use this permission if you need it to help the Page Admin administer and manage the Page.
pages_manage_posts The pages_manage_posts permission allows your app the ability 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. You can use this permission to create and delete content on the Page.
pages_messaging The pages_messaging permission allows your app to manage and access Page conversations in Messenger. You can use this permission to create user-initiated interactive experiences, send customer support messages or to confirm bookings or purchases and orders.
pages_read_engagement The pages_read_engagement permission allows your app the ability 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. You can use this permission if you need it to help the Page Admin administer and manage the Page.
pages_read_user_content The pages_read_user_content permission allows your app the ability 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. You can use this permission to read Users and other Page’s content posted on the Page if you need it to help manage the Page.
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.
pages_user_gender The pages_user_gender permission allows your app access to a user's gender through the Page your app is connected to. You can use this permission to personalize the experience of people interacting with your Messenger integration.
pages_user_locale The pages_user_locale permission allows your app access to 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.
pages_user_timezone The pages_user_timezone permissions 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.
publish_pages

Deprecated for v7.0+.

The publish_pages permission allows your app to publish posts, comments and like Pages managed by the app user. You can use this permission to allow app users to explicitly publish content from your app to any of the Facebook Pages they manage from within a custom composer. Note: Requires the manage_pages permission to work correctly.
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. You can use this permission to allow people to publish content from your app to their Facebook group or to help people manage the content published to their group.
publish_video The publish_video permission allows your app to publish live videos to an app user's timeline. You can also use this permission to live video stream to an end user's timeline.

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. You can use this permission to integrate these Facebook insights into your own analytics tools.

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. You can use this permission if your app is legally required to be age-gated and if your app contains content that is not suitable for the general Facebook user base, such as dating, violent or mature content.
user_birthday The user_birthday permission allows your app to read a user's birthday as listed in their Facebook profile. You can use this permission to provide age relevant content to people when their age range is not sufficient.
user_friends The user_friends permission allows your app to get a list of a user's friends using that app. You can use this permission to provide Facebook related content to personalize a persons experience.
user_gender The user_gender permission allows your app to read a person's gender as listed in their Facebook profile. You can use this permission to render pronouns and to personalize a person's experience based on gender, like for dating, shopping and fashion apps.
user_hometown The user_hometown permission allows your app to read a user's hometown location from their Facebook profile. You can use this permission to provide a personalized experience based on where a person lived or grew up.
user_likes The user_likes permission allows your app to read a list of all Facebook Pages that a user has liked. You can use this permission to provide a personalized experience by correlating or surfacing content related to the the person's likes. This includes curating content at scale to customize apps with large amounts of content and to enable people to share their likes with others, such as in the case of dating and music apps.
user_link The user_link permission allows your app to access the Facebook profile URL of the person using your app. You can use this permission to provide a way for someone who uses your app to visit that person's Facebook profile.
user_photos The user_photos permission allows your app to read the photos a person has uploaded to Facebook. You can use this permission to create physical or digital books of 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 others within the app, like 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.
user_posts The user_posts permission allows your app to access the posts that person has makes on their timeline, but not the comments on those posts. You can use this permission 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.
user_videos The user_videos permission allows your app to read a list of videos uploaded by a user. You can use this permission to display a person's videos on a TV via a set-top box or display their videos 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, like in dating or social apps.

W

PermissionDescription
whatsapp_business_management The whatsapp_business_management permission lets your app 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. You can use this permission to display WhatsApp Business Account analytics in your customer portal or to manage message templates for WhatsApp Business Accounts.