Facebook
    Permissions Reference - App Development with Meta - Documentation - Meta for Developers
    App Development with Meta

    Permissions Reference for Meta Technologies APIs

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

    Requirements

    Ways to ask for a permission

    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.

    Remove a 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.

    A

    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
    • Programmatically create campaigns, manage ads, and fetch metrics.
    • Build ad management tools that provide innovative solutions and differentiated value for advertisers.
    Provide specific examples of why your app requires managing ads on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how a business can access ads performance data on your app platform after granting the permission.
    3. Showcase that the ads performance data, such as Impressions, Conversions, Spend, Clicks, and Reach, are displayed successfully on your app platform.

    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 API access to your ad performance data for use in custom dashboards and data analytics.
    • Send web events from your server directly to Facebook.
    Provide specific examples of why your app requires accessing ads and related statistics on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how a business can access ads performance data on your app platform after granting the permission.
    3. Showcase that the ads performance data, such as Impressions, Conversions, Spend, Clicks, and Reach, are displayed successfully on your app platform.

    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
    • Provides the ability for your app to access ads performance data from Attribution for use in custom dashboards and data analytics.
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    B

    Permission
    Description and allowed usage
    What to include in App Review submission
    business_management

    Dependencies
    pages_read_engagement
    pages_show_list
    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.

    Allowed Usage
    • Manage business assets such as an ad account.
    • Claim ad accounts.
    Use Case Description

    Provide specific examples of why your app requires managing business assets on behalf of other businesses. If the permission is requested as a dependency of another main permission, including pages_messaging or pages_show_list , please specify the main permission in the use case description.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how a business can access ads performance data on your app platform after granting the permission.
    3. Showcase that the ads performance data, such as Impressions, Conversions, Spend, Clicks, and Reach, are displayed successfully on your app platform.

    C

    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
    • Build commerce-related solutions like ecommerce platforms, travel platforms and dynamic ads.
    • Build inventory type management solutions like product inventory, hotel inventory or car inventory.
    Use Case Description
    Provide specific examples of why your app needs to manage the product catalogs of businesses that grant you access.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how your app user creates, updates, and deletes a product catalog on your app platform

    commerce_account_manage_orders

    The commerce_account manage_orders permission allows your app to read and update commerce account orders.
    Allowed Usage
    • Read and update orders in your commerce account.
    • Tech providers manage orders on behalf of their customers.
    • Access to Webhook notifications.
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    commerce_account_read_orders

    The commerce_account_read_orders permission allows your app to read commerce account orders.
    Allowed Usage
    • Read orders in your commerce account.
    • Use the buyer's email address for marketing purposes only if a buyer has opted-in at checkout.
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    commerce_account_read_reports

    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
    • Read finance reporting data in your commerce account for building custom tax cash reconciliation and reimbursement reports.
    • Tech providers can run finance reports on behalf of their customers.
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    commerce_account_read_settings

    The commerce_account_read_settings permission allows your app to read commerce account settings.
    Allowed Usage
    • Read basic commerce account information like connected channels, shipping options, fulfillment locations, connected business, etc.
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    commerce_manage_accounts

    The commerce_manage_accounts permission allows your app to create and manage commerce accounts, such as an ecommerce app.
    Allowed Usage
    • Associate your app with your commerce account.
    • Tech providers create a commerce account on behalf of their customers.
    • Tech providers enable a new sales channel within their customer’s commerce account.
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    E

    Permission
    Description and allowed usage
    What to include in App Review submission

    email

    The email permission allows your app to read a person's primary email address.
    Allowed Usage
    • Communicating with people and letting them log into your app with the email address associated with their Facebook profile.
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    F

    Permission
    Description and allowed usage
    What to include in App Review submission
    facebook_branded_content_ads_brand

    Dependencies
    pages_read_engagement
    pages_show_list
    The facebook_branded_content_ads_brand allows an app to read Facebook posts where the app user's Facebook profile 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 Facebook 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
    • Allow a business to read Facebook posts where the account is tagged as a paid partner
    • Manage permissions to run Partnership Ads without needing a pre-existing post
    Use Case Description

    Provide specific examples of why your app requires access to manage Facebook branded content ad campaigns and access data related to branded content ads on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Facebook Login for Business process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how your app user selects a branded content post and promotes the post as an ad on your app platform.
    facebook_creator_marketplace_discovery




    Dependencies
    pages_show_list
    The facebook_creator_marketplace_discovery permission allows an app to discover content creators on Facebook's creator discovery platform. The allowed usage for this permission is for Facebook businesses to retrieve insights data for eligible Facebook creators in order to discover and evaluate them for brand campaigns, and to credit and pay creators for their Facebook presence.
    Allowed Usage
    • Retrieve insights data for eligible Facebook creators in order to discover and evaluate them for brand campaigns
    • To credit and pay creators for their Facebook presence
    Use Case Description

    Provide specific examples of why your app requires managing Facebook creator discovery on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how to search for Creators on the Facebook Creator Discovery platform, and highlight how to access insights on the Creators such as creator bio, follower count, and account reach.
    3. Demonstrate how you intend to use the insights data you have obtained in line with permitted purposes and showing compliance with all applicable data usage and privacy policies.

    G

    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
    • Display a game interface in the user's preferred language.
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    I

    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
    • Get basic metadata of an Instagram Business account profile, for example username and ID.
    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
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission and selects their Instagram account
    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
    • Read Instagram posts where the account is tagged as a paid partner
    • Manage permissions to run Partnership Ads without needing a pre-existing post
    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
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how your app user selects a branded content post and promotes the post as an ad on your app platform.
    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
    • Manage branded creator content settings on a business’ Instagram account.
    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
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how your app user adds, removes, and views creators from a brand's approved creators list on your app platform
    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
    • Read Instagram posts where the account is tagged as a paid partner
    • Manage permissions to run Partnership Ads without needing a pre-existing post
    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
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how your app user selects a branded content post and promotes the post as an ad on your app platform.
    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
    • Get basic metadata of an Instagram Business account profile
    Use Case Description

    Provide specific examples of why your app requires the instagram_business_basic permission to access basic metadata of Instagram Business account profiles on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Instagram login process on your app platform, showing how your app user grants your app this permission
    2. Demonstrate getting basic metadata, such as the username and ID, of an Instagram Business account profile on your app platform
    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
    • Manage the organic content creation process for Instagram (for example, post photos and videos) on behalf of an Instagram business account
    Use Case Description

    Provide specific examples of why your app requires the instagram_business_content_publish permission to create and publish organic feed photo and video posts on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Instagram login process on your app platform, showing how your app user grants your app this permission
    2. Demonstrate creating a new organic feed photo post on behalf of a business user
    3. Show how to add a caption, hashtags, and other metadata, and post to the business user's Instagram feed
    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
    • Manage the organic content creation process for Instagram (for example, post photos and videos) on behalf of an Instagram business account
    Use Case Description

    Provide specific examples of why your app requires the instagram_business_manage_comments permission to manage Instagram comments on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Instagram login process on your app platform, showing how your app user grants your app this permission
    2. Demonstrate creating a new comment, updating an existing comment and deleting a comment
    3. Show how this appears both in your app and the native Instagram app
    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
    • View, manage, and respond to messages
    • Use third-party customer relationship management (CRM) tools to manage messages
    Use Case Description
    Explain the messaging functionality your app offers to business customers who are onboarded onto the platform, and describe how they perform these functions.
    Screencast Requirements
    1. Demonstrate the complete Instagram login process on your app platform, showing how your app user grants your app this permission
    2. Demonstrate your app sending a message to an Instagram user, and demonstrate the Instagram inbox client (either web or mobile app) receiving and displaying the sent message
    3. Demonstrate generating a cURL request that you can integrate into your app platform to send a message; You may use the API Integration Helper in Meta App Dashboard > Instagram to do this
    instagram_creator_marketplace_discovery


    Dependencies
    • business_management
    • instagram_basic
    • pages_manage_metadata
    • pages_show_list
    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
    • Retrieve insights data for eligible Instagram creators, like creator bio, follower count, and account reach.
    Use Case Description

    Provide specific examples of why your app requires managing instagram_creator_marketplace_discovery on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how to search for Creators on Instagram Creator Marketplace, and highlight how to access Insights on the Creators such as creator bio, follower count, and account reach.
    instagram_creator_marketplace_messaging


    Dependencies
  • instagram_basic
  • pages_read_user_content
  • pages_show_list
    • The instagram_creator_marketplace_messaging permission allows your 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
    • Allows brands on the Instagram creator marketplace to send paid partnership messages to creators.
    Use Case Description

    Provide specific examples of why your app requires managing instagram creator marketplace messages on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Facebook Login for Business process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how to retrieve partnership conversations and messages.
    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
    • Managing organic content creation process for Instagram (for example, post photos and videos to main feed) on behalf of a business.
    Use Case Description

    Provide specific examples of why your app requires the instagram_content_publish permission to create and publish organic feed photo and video posts on Instagram on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate creating a new photo post and publish the post to the business user's Instagram feed
    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
    • Read, update and delete comments of Instagram Business accounts.
    Use Case Description

    Provide specific examples of why your app requires the instagram_content_publish permission to create and publish organic feed photo and video posts on Instagram on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate creating a new photo post and publish the post to the business user's Instagram feed
    instagram_manage_contents


    Dependencies
    instagram_basic
    The instagram_manage_contents permission allows your app to delete posts on behalf of an Instagram account linked to a Facebook Page. The allowed usage for this permission is to allow an app user to delete an Instagram post, story or reel.
    Allowed Usage
    • Delete an Instagram post, story or reel.
    Use Case Description

    Provide specific examples of why your app requires the instagram_manage_contents permission to delete an app user's Instagram media.
    Screencast Requirements
    1. Demonstrate the completed Facebook Login for Business process on your app platform, showing how a business grants your app the instagram_manage_contents permission.
    2. Demonstrate deleting Instagram media from the business user's Instagram feed.
    instagram_manage_engagement


    Dependencies
  • instagram_basic
  • pages_read_user_content
  • pages_show_list
    • The instagram_manage_engagement permission allows your app to publish or delete a "Like" on IG Media objects, Feed or Reels, and IG Comment objects, Comment or Reply, on behalf of an Instagram account linked to a Facebook Page. The allowed usage for this permission is to allow an app user to publish or delete a "Like" on IG Media objects, Feed or Reels, and IG Comment objects, Comment or Reply.
    Allowed Usage
    • Publish or delete a "Like" on IG Media objects, Feed or Reels
    • Publish or delete a "Like" on IG Comment objects, Comment or Reply
    Use Case Description

    Provide specific examples of why your app requires the instagram_manage_engagement permission to publish or delete an app user's “Like” on IG Media objects (Feed, Reels) and IG Comment objects (Comment, Reply).
    Screencast Requirements
    1. Demonstrate the completed Facebook Login for Business process on your app platform, showing how a business grants your app the instagram_manage_engagement permission.
    2. Demonstrate publishing or deleting a "Like" Instagram media from the business user's Instagram feed.
    3. Demonstrate publishing or deleting a "Like" on Instagram Comment objects.
    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
    • Log events on Instagram accounts and send this activity data to Meta for ads targeting, optimization and reporting
    • Provide marketing and advertising analytics insights
    Use Case Description

    Provide specific examples of why your app requires the instagram_manage_upcoming_events permission to manage upcoming events on Instagram on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate retrieving a list of upcoming events and demonstrate how to view event details
    3. Create a new event and demonstrate how to add event details such as title, date, time, and location
    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
    • Get metadata of an Instagram Business account.
    • Get data insights of an Instagram Business account.
    • Get story insights of an Instagram Business account.
    Use Case Description

    Provide specific examples of why your app requires the instagram_manage_insights permission to provide insights into Instagram performance on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate getting insights for the app user's Instagram professional account metadata, posts, photos, and videos
    3. Demonstrate getting insights for an Instagram professional account's public profile metadata and media on behalf of the app user's Instagram professional account
    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
    • Business that want to retrieve threads and messages from its Direct inbox.
    • Business that want to manage messages with their customer.
    • Business that want to use third-party customer relationship management (CRM) tools to manage its IG Direct inbox.
    Use Case Description
    Explain the messaging functionality your app offers to business customers who are onboarded onto the platform, and describe how they perform these functions.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate your app sending a message to an Instagram user, and demonstrate the Instagram inbox client (either web or mobile app) receiving and displaying the sent message
    3. Generate a cURL request that you can integrate into your app platform to send a message; You may use the API Integration Helper in Meta App Dashboard > Instagram to do this
    4. Make sure it is a recording of the message being sent from the app to the user, instead of sharing screenshots of messages received on Instagram inbox client
    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
    • Check eligibility for product tagging
    • Get catalogs and products
    • Tag media with product tags
    • Manage existing product tags
    • Appeal product rejections
    Use Case Description

    Provide specific examples of why your app requires the instagram_shopping_tag_products permission to tag Instagram media with product tags and manage the product catalog on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate retrieving a list of available catalogs and products and demonstrate how to select one
    3. Tag a piece of media with a product tag
    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
    • Manage upcoming events on Instagram accounts administered by the people using the app
    Use Case Description

    Provide specific examples of why your app requires the instagram_manage_upcoming_events permission to manage upcoming events on Instagram on behalf of other businesses.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate retrieving a list of upcoming events and demonstrate how to view event details
    3. Create a new event and demonstrate how to add event details such as title, date, time, and location

    L

    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
    • 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.
    • For 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.
    Use Case Description
    Provide specific examples of why your app needs to access leads for the pages that grant you access.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    M

    Permission
    Description and allowed usage
    What to include in App Review submission

    manage_app_solutions

    The manage_app_solution permission allows an app to get a list of apps that a user can manage, and make API calls on behalf of those apps. The allowed usage for this permission is to let a business create and manage partner solutions between Tech Providers and Solution Partners.
    Allowed Usage
    • Let a business create and manage partner solutions between Tech Providers and Solution Partners
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    manage_fundraisers

    The manage_fundraisers permission allows an app to create, update, and read a fundraiser and its donations on behalf of a user.
    Allowed Usage
    • Help fundraiser creators to expand their reach on Facebook.
    • Sync the amount raised displayed on the fundraiser's website and the linked Facebook fundraiser.
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.
    marketing_messages_messenger


    Dependencies
    • ads_management
    • pages_messaging
    The marketing_messages_messenger permission allows an app to create, manage, and send paid marketing messages on Messenger and to view the performance of these marketing messages campaigns on behalf of the app user using their authorized Ad Accounts. The allowed usage for this permission is to allow an app user, such as a business, to send paid marketing messages on Messenger to people who have chosen to receive announcements and promotional messages from specific Facebook Pages managed by the app user.
    Allowed Usage
    • Send paid marketing messages on Messenger to people who have chosen to receive announcements and promotional messages
    Use Case Description

    Provide specific examples of why your app requires the marketing_messages_messenger permission to access Marketing Messages endpoints on Messenger
    Screencast Requirements
    1. Demonstrate the complete Facebook Login for Business process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how your app user selects the Pages and Ad Accounts on your app platform; and
    3. The process of agreeing to the Marketing Messages Beta ToS for those assets.
    4. Demonstrate the ability to create and send marketing messages messenger.

    P

    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
    • Send businesses related activities (for example purchase, add-to-cart, lead) on behalf of Pages owned by the people who use your app.
    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
    • Create ads for your Page.
    • Manage ads for your Page.
    • Create and manage ads that click to a business messaging surface.
    Use Case Description
    Provide specific examples of why your app requires creating and managing ads on behalf of other businesses for their pages.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how your app user creates an ad for their Facebook Page on your app platform
    3. Showcase that the ads are created successfully on 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 call-to-action buttons on a Facebook Page.
    Allowed Usage
    • Provide API access to manage call-to-action buttons on Pages that you manage.
    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
    • Create and update Instant Articles for Pages owned by the people who use your app.
    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
    • Publish a comment on a Page post.
    • Update your comment on a Page post.
    • Delete a comment on a Page post.
    • Like a Page post or remove your Like from a Page post.
    Use Case Description
    Provide specific examples of why your app needs to manage comments on behalf of other users on the pages they own.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how your app user publishes a comment on their Facebook Page on your app platform
    3. Show the newly published comment on the app user's page
    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
    • Subscribe to receive webhooks of your Page.
    • Update settings of your Page.
    Use Case Description
    Provide specific examples of why your app needs to manage accounts, settings, or webhooks for a page on behalf of other users who own the page(s).
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how your app user subscribes to webhook events or updates the settings of their Facebook Page on your app platform
    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
    • Publish a post, photo, or video to your Page.
    • Update a post, photo, or video on your Page.
    • Delete a post, photo, or video on your Page.
    Use Case Description
    Provide specific examples of why your app needs to create or manage posts on behalf of other users for the pages they own.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how your app user creates, edits, and deletes a post on their Facebook Page on your app platform
    3. Showcase the newly updated post on their page
    pages_messaging


    Dependencies
    pages_manage_metadata
    pages_show_list
    The pages_messaging permission allows your app to manage and access Page conversations and calling in Messenger. The allowed usage for this permission is to create user-initiated interactive experiences, send customer support messages, confirm bookings or purchases and orders, and facilitate calls between a business and its customers.
    Allowed Usage
    • Create interactive experiences initiated by a user.
    • Confirm customer interactions such as purchases, orders and bookings.
    • Send customer support messages.
    • Handle inbound and outbound calls between businesses and customers.
    Use Case Description
    Provide specific examples of why your app requires creating and managing ads on behalf of other businesses for their pages.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate one of the following:
      • Demonstrate receipt of inbound calls from customers or Demonstrate outbound calls to customers; or
      • Demonstrate your app sending a message to a Messenger user, and demonstrate the Messenger inbox client (either web or mobile app) receiving and displaying the sent message.
        1. Generate a cURL request that you can integrate into your app platform to send a message; You may use the API Integration Helper in Meta App Dashboard > Messenger to do this.
        2. Make sure it is a recording of the message being sent from the app to the user, instead of sharing screenshots of messages received on Messenger client.
    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
    • Get content posted by your Page.
    • Get names, PSIDs, and profile pictures of your Page followers.
    • Get metadata about your Page.
    Use Case Description
    Provide specific examples of why your app needs to read content posted on behalf of other users for the pages they own.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how your app user accesses a post's content on their Facebook Page on your app platform
    3. Showcase that the post content is successfully displayed on your app platform
    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
    • Get user generated content on your Page.
    • Get posts that your Page is tagged in.
    • Delete comments posted by users on your Page.
    Use Case Description
    Provide specific examples of why your app needs to read user-generated content on behalf of your app users for the pages they own.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how your app user reads a user-generated comment on their Facebook Page on your app platform
    3. Showcase that the user-generated comment is successfully displayed on your app platform
    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
    • Show a person the list of Pages they manage.
    • Verify that a person manages a Page.
    Use Case Description

    Provide specific examples of why your app needs to access the list of pages that a user owns. If the pages_show_list permission is requested as a dependency of another main permission, please specify the main permission in the use case description.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Showcase that the pages owned by the user are successfully connected with your app platform.

    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.
    Allowed Usage
    • Personalize experiences or recommendations based on gender.
    • Use gendered language such as correct pronouns and titles.
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    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.
    Allowed Usage
    • Personalize experiences based on the locale of a person by surfacing locale specific content.
    • Send responses in the preferred language of the person.
    • Display numbers, times, and dates correctly for the locale of the person.
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    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.
    Allowed Usage
    • Prevent messages from being sent at an inconvenient time.
    • Send time sensitive content or recurring news at a specific time.
    • Provide tailored content based on time.
    • Send time appropriate greetings.
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    pages_utility_messaging

    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
    • Manage a Page's utility messaging templates
    • Send a Page's utility messages through Messenger
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.
    paid_marketing_messages
    The paid_marketing_messages permission allows an app to create, manage, and send paid marketing messages on Messenger and to view the performance of these marketing messages campaigns on behalf of the app user. The allowed usage for this permission is to allow an app user, such as a business, to send paid marketing messages on Messenger to people who have chosen to receive announcements and promotional messages from the app user.
    Allowed Usage
    • Send paid marketing messages on Messenger to people who have chosen to receive announcements and promotional messages
    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
    • Authenticate app users and provide them with a personalized in-app experience.
    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
    • Grants an app permission to live-video stream to an app user's timeline, group, event or Page.
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    R

    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
    • Integrate Audience Network properties performance data into app owner’s data analytics and dashboards
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    read_insights



    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
    • Integrate Facebook's app, page or domain insights into your own analytics tools.
    Use Case Description
    Provide specific examples of why your app needs to access Page insights on behalf of your app users for the pages they own.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate how your app user retrieves insight metrics from their Facebook Page on your app platform
    3. Showcase that the insight metrics are successfully displayed on your app platform

    T

    Permission
    Description and allowed usage
    What to include in App Review submission

    threads_basic

    The threads_basic permission allows an app to get a user's Threads profile information and the media and text content that they posted to Threads. The allowed usage for this permission is to display a user’s own Threads posts within a business app, and make these visible only to the user who created them.
    Allowed Usage
    • Display a user’s own Threads posts within an app, and make these visible only to the user who created them for the purpose of managing the user's presence on Threads.
    Use Case Description

    Provide specific examples of why your app requires the threads_basic permission to access a user's Threads profile information and media and text content posted to Threads.
    Screencast Requirements
    1. Demonstrate the complete Threads OAuth login process on your app platform, showing how your app user grants your app this permission
    2. Demonstrate the full flow of linking a Threads account within your application and show what permissions are being requested from the user
    3. Retrieve a list of the user's own Threads posts and demonstrate how to view post details such as text, images, and videos

    threads_business_basic

    The threads_business_basic permission allows a business app to fetch the Threads account ID that is associated with an Instagram account within the Business Portfolio through matching username. The allowed usage for this permission is to retrieve a Threads account ID to use as the threads_user_id during the creation of ads on Threads. It is not intended for any other purpose. For example, using threads_business_basic permission in a consumer app is strictly prohibited. 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
    • Retrieve a Threads account ID to use as the threads_user_id during the creation of ads on Threads, for the purpose of managing the user's presence on Threads.
    Use Case Description

    Provide specific examples of why your app requires the threads_business_basic retrieve the threads_user_id during the creation of ads on Threads.
    Screencast Requirements
    1. Demonstrate the complete Facebook login process on your app platform, showing how your app user grants your app this permission along with selecting the Instagram account connected to a Threads account
    2. Demonstrate how your app user creates an ad to be shown on Threads on your app platform

    threads_content_publish



    Dependencies
    threads_basic
    The threads_content_publish permission allows a business app to create and publish content on behalf of a Threads profile. The allowed usage for this permission is to enable a business app user to create and publish content to their Threads 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).
    Allowed Usage
    • Enables an app user to create and publish content to their Threads profile, for the purpose of managing the user's presence on Threads.
    Use Case Description

    Provide specific examples of why your app requires the threads_content_publish permission to enable users to create and publish content to their Threads profile.
    Screencast Requirements
    1. Demonstrate the complete Threads OAuth login process on your app platform, showing how your app user grants your app this permission
    2. Demonstrate the full flow of linking a Threads account within your application and show what permissions are being requested from the user
    3. Create a new post and demonstrate how to add text, images, or videos
    4. Publish the post to the Threads profile and demonstrate how to view the published content
    5. Show the results of the post creation in your app and in the native Threads App

    threads_delete



    Dependencies
    threads_basic
    The threads_delete permission allows an app to delete an app user's Threads posts. The allowed usage for this permission is to delete an app user's Thread posts. 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
    • Delete an app user's Thread posts.
    Use Case Description

    Provide specific examples of why your app requires the threads_delete permission to delete an app user's Thread post.
    Screencast Requirements
    1. Demonstrate the complete Threads OAuth login process on your app platform, showing how your app user grants your app this permission
    2. Demonstrate the full flow of linking a Threads account within your application and show what permissions are being requested from the user
    3. Select a post and demonstrate how to delete it
    4. Confirm that the post has been successfully deleted
    5. Show the results of the post creation in your app and in the native Threads App

    threads_keyword_search



    Dependencies
    threads_basic
    The threads_keyword_search permission allows an app to search and fetch content with a specific keyword on behalf of a Threads user. The permission also allows for publishing responses to this fetched content. The allowed usage for this permission is to help the user manage their social media presence. 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
    • Showing public content and the public content tree that a user searches using a specific keyword.
    • Giving the user the ability to sort user’s own mentioned threads.
    • Giving the user the ability to publish responses to public content that the user searches for.
    Use Case Description

    Provide specific examples of why your app requires the threads_keyword_search permission to manage your social media presence by searching and fetching content with specific keywords on Threads.
    Screencast Requirements
    1. Demonstrate the complete Threads OAuth login process on your app platform, showing how your app user grants your app this permission
    2. Demonstrate the full flow of linking a Threads account within your application and show what permissions are being requested from the user
    3. Enter a keyword and demonstrate how to search for public content related to that keyword
    4. Show the results of the post creation in your app and in the native Threads App

    threads_location_tagging



    Dependencies
    threads_basic
    The threads_location_tagging permission allows an app to search for and fetch public locations using specific queries/keywords or coordinates on behalf of a Threads user and publish media with a location tagged. The allowed usage for this permission is to help users tag public locations to their posts and request locations when media is retrieved. 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
    • Helps users tag public locations to their posts and request locations when media is retrieved.
    Use Case Description

    Provide specific examples of why your app requires the threads_location_tagging permission to enable users to read location information or publish a post with location information
    Screencast Requirements
    1. Demonstrate the complete Threads OAuth login process on your app platform, showing how your app user grants your app this permission
    2. Demonstrate the full flow of linking a Threads account within your application and show what permissions are being requested from the user
    3. Demonstrate Location Information Usage
    4. Show how to read location information or publish a post with location information

    threads_manage_insights



    Dependencies
    threads_basic
    The threads_manage_insights permission allows your app to get access to insights for a Threads profile. The allowed usage for this permission is to allow your app to get insights for a Threads profile and for individual threads published by that 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).
    Allowed Usage
    • Get insights for a Threads profile
    • Get insights for individual threads published by that profile
    Use Case Description

    Provide specific examples of why your app requires the threads_manage_insights permission to track your performance on Threads by providing insights into your profile and individual Threads metrics.
    Screencast Requirements
    1. Demonstrate the complete Threads OAuth login process on your app platform, showing how your app user grants your app this permission
    2. Demonstrate the full flow of linking a Threads account within your application and show what permissions are being requested from the user
    3. Retrieve insights data for a Threads profile and demonstrate how to view profile-level metrics such as followers, engagement, and reach
    4. Retrieve insights data for an individual thread and demonstrate how to view thread-level metrics such as likes, comments, and shares

    threads_manage_mentions



    Dependencies
    threads_basic
    The threads_manage_mentions permission allows an app to fetch content where the user is mentioned in on behalf of a Threads user. The allowed usage for this permission is to help the user manage their social media presence, which includes: showing public content and the public content tree that a user is mentioned in, enabling the user to sort user’s own mentioned threads, and enabling the user to publish responses to the public content tree that the user is mentioned in. 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
    • Showing public content and the public content tree that a user is mentioned in.
    • Giving the user the ability to sort user’s own mentioned threads.
    • Giving the user the ability to publish responses to public content that a user is mentioned in.
    Use Case Description

    Provide specific examples of why your app requires the threads_manage_insights permission to track your performance on Threads by providing insights into your profile and individual Threads metrics.
    Screencast Requirements
    1. Demonstrate the complete Threads OAuth login process on your app platform, showing how your app user grants your app this permission
    2. Demonstrate the full flow of linking a Threads account within your application and show what permissions are being requested from the user
    3. Retrieve public content where the user is mentioned and demonstrate how to view the content tree

    threads_manage_replies



    Dependencies
    threads_basic
    The threads_manage_replies permission allows an app to create a reply on behalf of a Threads profile, hide or unhide replies to a thread, and control who can reply to a thread on the Threads profile. The allowed usage of this permission is to allow an app to create a reply on behalf of a Threads profile, hide or unhide replies to a thread, and control who can reply to a thread on the Threads 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).
    Allowed Usage
    • Create a reply on behalf of a Threads profile
    • Hide or unhide replies to a thread
    • Control who can reply to a thread on the Threads profile
    Use Case Description

    Provide specific examples of why your app requires the threads_manage_replies permission to enable users to manage their Threads presence by creating replies on behalf of their profile, hiding or unhiding replies to threads, and controlling who can reply to threads.
    Screencast Requirements
    1. Demonstrate the complete Threads OAuth login process on your app platform, showing how your app user grants your app this permission
    2. Demonstrate the full flow of linking a Threads account within your application and show what permissions are being requested from the user
    3. Demonstrate one of the following: Demonstrate Creating a Reply on Behalf of a Threads Profile
    4. Create a new reply and demonstrate how to add text, images, and other media
    5. Demonstrate Hiding or Unhiding Replies to a Thread
    6. Hide a reply and demonstrate how to unhide it
    7. Demonstrate Controlling Who Can Reply to a Thread on the Threads Profile
    8. Set the reply control to "Everyone" and demonstrate how to change it to "People you follow”
    threads_profile_discovery


    Dependencies
    threads_basic
    The threads_profile_discovery permission allows an app to access profiles for public Threads accounts and public posts of these accounts. The allowed usage for this permission is to allow the app's users to find profiles of public Threads accounts and public posts of these accounts to conduct competitor analyses.
    Allowed Usage
    • Allow the app's users to find profiles of public Threads accounts and public posts of these accounts to conduct competitor analyses.
    Use Case Description

    Provide specific examples of why your app requires the threads_profile_discovery permission to enable users to access profiles for public Threads accounts and public posts of these accounts.
    Screencast Requirements
    1. Demonstrate the complete Threads OAuth login process on your app platform, showing how your app user grants your app this permission.
    2. Demonstrate the full flow of linking a Threads account within your application and show what permissions are being requested from the user.
    3. Search for a Public Threads Profile and/or demonstrate how to search for public posts on that profile.

    threads_read_replies



    Dependencies
    threads_basic
    The threads_read_replies permission allows an app to read replies to a user's thread. The allowed usage for this permission is to get replies to a thread owned by the app user. 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
    • Get replies to a thread owned by the app user
    Use Case Description

    Provide specific examples of why your app requires the threads_read_replies permission to enable users to view replies to their threads on Threads.
    Screencast Requirements
    1. Demonstrate the complete Threads OAuth login process on your app platform, showing how your app user grants your app this permission
    2. Demonstrate the full flow of linking a Threads account within your application and show what permissions are being requested from the user
    3. Retrieve replies to a thread and demonstrate how to view reply text and media
    threads_share_to_instagram


    Dependencies
    None
    The threads_share_to_instagram permission allows your app to post your app user's Threads post to their linked Instagram account on behalf of the user. The allowed usage for this permission is to enable a user to post their Threads content to their linked Instagram account, either as a one-time action or automatically for future posts.
    Allowed Usage
    • Post your app user's Threads content to their linked Instagram account
    Use Case Description

    Visit the App Review documentation for guidance.
    Screencast Requirements

    Visit the App Review documentation for guidance.

    U

    Permission
    Description

    user_age_range

    The user_age_range permission allows your app to access a person's age range as listed in their Facebook profile.
    Allowed Usage
    • Your app is legally required to be age-gated.
    • Your app contains content that is not suitable for the general Facebook user base, for example dating, violent or mature content.

    user_birthday

    The user_birthday permission allows your app to read a person's birthday as listed in their Facebook profile.
    Allowed Usage
    • 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 person's friends using that app.
    Allowed Usage
    • Provide Facebook-related content to personalize a person's experience.

    user_gender

    The user_gender permission allows your app to read a person's gender as listed in their Facebook profile.
    Allowed Usage
    • To render pronouns.
    • Personalize a person's experience based on gender, for example dating, shopping and fashion apps.

    user_hometown

    The user_hometown permission allows your app to read a person's hometown location from their Facebook profile.
    • 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.
    Allowed Usage
    • 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 to enable people to share their likes with others, such as in the case of dating and music apps.
    • Allow parental access controls and monitoring apps to analyze user likes for potential safety and wellbeing issues for people under 18 years old, as used solely by parents and guardians for under 18 year old dependents and limited to youth social media analysis as presented in the app’s user interface.

    user_link

    The user_link permission allows your app to access the Facebook profile URL of the person using your app.
    Allowed Usage
    • Provide a way for someone who uses your app to visit another person's Facebook profile.

    user_location

    The user_location permission allows your app to read the city name as listed in the location field of a person's Facebook profile.
    • Provide a personalized experience based on the city name as listed in the location field of a person's Facebook profile.

    user_messenger_contact

    The user_messenger_contact permission allows a business to contact a person via Messenger upon their approval or initiation of a chat thread with the business's Page.
    Allowed Usage
    • For a Page to send a person an initial message, post-purchase updates and account updates.

    user_photos

    The user_photos permission allows your app to read the photos a person has uploaded to Facebook.
    Allowed Usage
    • Create physical or digital books or albums of a person's photos, which includes permitting people to export photos for printing.
    • Provide people with the ability to display their photos with other app users, for example in dating or social apps.
    • 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 a user has made on their timeline.
    Allowed Usage
    • Enable people to create physical or digital books or albums of their timelines, and to share memories from their timeline on Facebook or on other social apps.
    • Allow parental access controls and monitoring apps to analyze a post's content to detect potential risk to safety or wellbeing for people under 18 years old, as used solely by parents and guardians for under 18 year old dependents and limited to youth social media analysis as presented in the app’s user interface.

    user_videos

    The user_videos permission allows your app to read a list of videos uploaded by a person.
    Allowed Usage
    • Display a person's videos on a TV via a set-top box or in a digital photo frame.
    • Provide people with the ability to edit or create new video content using existing videos.
    • Provide people with the ability to display their video with owners within their app, for example in dating or social apps.

    W

    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
    • Log events on WhatsApp business accounts
    • Send events activity data to Meta for ads targeting, optimization and reporting
    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
    • Manage WhatsApp business assets.
    • Display WhatsApp Business Account analytics in your customer portal.
    Use Case Description
    Provide specific examples of why your app requires access to the business assets of a business that has onboarded onto your platform.
    Screencast Requirements

    Demonstrate one of the following:

    1. Demonstrate how your app user creating a message template on your app or the WhatsApp Manager.
    2. Demonstrate your app user enabling the Call Button icon for the WhatsApp business either: (1) by CURL request; or (2) through settings within your application UI. Once enabled, open the chat thread with your business from the WhatsApp user app and show that the Call Button icon is visible for the user in the chat thread with your business.
    whatsapp_business_messaging


    Dependencies
    whatsapp_business_management
    The whatsapp_business_messaging permission allows an app to send WhatsApp messages and make calls 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 and calling experiences initiated by a customer or a business.
    Allowed Usage
    • Send WhatsApp messages to a specific phone number
    • Upload and retrieve media from messages
    • Make WhatsApp calls to a specific phone number
    • Manage and get WhatsApp business profile information
    • Register a phone number with Meta
    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

    Demonstrate one of the following:

    1. Demonstrate your app sending a message to a WhatsApp number, and demonstrate the WhatsApp client (either web or mobile app) receiving and displaying the sent message. You can use the WhatsApp > API Setup panel in the Meta App Dashboard to generate a cURL request that you can integrate into your app to send the message.
    2. Demonstrate that your app can place a business-initiated call and that a user accepts the call on a WhatsApp mobile client. Alternatively, you may demonstrate that a user can place a call to your business phone number and that your app receives the user-initiated call.

    Learn More
    Build a Mobile Site
    View Site in Mobile | Classic
    Share by: