Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Facebook Ads access levels and permissions

Updated on August 3, 2022

The app used for integration with Paid Media Manager should have the App Type set to Business. Business apps do not have app modes and instead use only access levels.

Pega Customer Decision Hub Paid Media Manager User Guide

Facebook Ads apps have two possible access levels: Standard and Advanced. When creating the app for Paid Media Manager integration, you can use the Standard access levels to generate the access token and test the app. By default, on the creation of the Business type app, all the permissions and features are provided with a Standard access level. If you are using the Lead Ads functionality, after you complete the testing, you must apply for the Advanced access level before going live with the integration.

Mandatory permissions

To integrate Paid Media Manager with Facebook Ads, you must obtain the following permissions:

  • ads_management - Required to manage the ad accounts, audiences, campaigns, ad sets, and insights.
  • business_management - To generate custom audiences, the ad account must be linked to the Business Manager account. This permission is required in order to validate this linking.

Mandatory feature

  • Ads Management Standard Access - This feature is required to lower the rate limiting. Using a large customer base can result in a high volume of API calls, which causes Facebook to apply rate limiting if your app does not have access to the Ads Management Standard Access feature.
    Note: Rate limiting is not affected by the access level of permissions.

Optional permissions for the Lead Ads functionality

In order to use the Lead Ads functionality, your Facebook app must have the following permissions:

  • leads_retrieval - Allows Paid Media Manager to retrieve the leads generated in Facebook.
  • page_manage_ads - As per Facebook permission guidelines, the permission is used in parallel to the leads_retrieval permission. It is not explicitly used anywhere in Paid Media Manager.
  • pages_show_list - To use lead ads, your Facebook app must be subscribed to the Facebook page. This permission is required for the subscription.
  • pages_read_engagement - Required to subscribe the Facebook app to the Facebook page, and to retrieve the leads generated in Facebook.
  • pages_manage_metadata - Required to subscribe Facebook app to the page, and for Facebook to send the leads to the Paid Media Manager service.
  • Previous topic Submitting a Facebook app for review
  • Next topic Applying for advanced access permissions for the Lead Ads functionality

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us