To use the Marketing API, your app must undergo App Review and, in most cases, include the
manage_pages login permission in your submission. Based on how you will use the API, you may have to complete additional steps, described in the following scenarios:
See our Sample App Review Submission for a detailed step-by-step guide.
If you are a business building tools for other businesses, you need to agree to supplemental terms and a Technology Provider amendment. This applies unless you are only building ads-related tools with Marketing API. If you are creating solutions for advertising on Facebook, see Building Tools with Marketing API.
In addition, if you are using Facebook's tools or data to provide service to other businesses, we will require you to share with Facebook who your customers are. We will announce a solution to help you do this by August 1, 2018. If your customers access large scale user data through your tool, we may also have additional requirements for them.
If your app uses any of the following functionality in Marketing API, your app must be reviewed by Facebook, you must go through business verification, and you must agree to our supplemental terms. Use of this API does not require signing Tech Provider Amendment or extended platform product terms. Learn more about theBusiness Manager API.
Let's say you are developing a browser-based app that your clients can use to create and run ads on Facebook. To access your clients' ad accounts, campaigns, and product catalogs through the Marketing API, your app needs to be approved for the Ads Management Standard Access level and the
You have already added and configured the Marketing API product to your app in the App Dashboard, and you have implemented Facebook Login so clients can grant your app the
After reading the access level and permissions descriptions, as well as our Platform Policy, and confirming that your app uses data in an approved manner, you begin the App Review process so you can take your app Live:
You sign into your App Dashboard and click App Review, then click Permissions and Features.
You search for "ads_management" to locate
Ads Management Standard Access, and request them both. You do the same with
catalog_management, and continue the request.
Now you describe how your app will use the data to which you are requesting access. In the Requests section, you click Edit Request.
Click the arrow icon in the Tell us how you'll use ads_management row.
Provide a general description of what your app does, then explain how the
ads_management permission will help the people using your app. You enter the following description in the Tell Us Why Are Requesting ads_management section:
"The app is used by advertising account managers to set up ad campaigns, manage ads, and view reports that show metrics about ads. The ads_management permission allows them to get data about existing Facebook ads and to create ads. Without this permission, the app can't function."
In the Upload Screencast section, you click Upload File and upload a short, minute-and-half screencast of a user signing into your app and exploring the user interface in the same way you described in your instructions.
You upload your screencast, which shows a user following your instructions.
You then save your changes and repeat these steps for the
catalog_management permissions and the Ads Management Standard Access level descriptions. Because your screencast shows how both permissions and your feature are used, you use the same screencast for all of them.
To complete the app verification process, click the arrow in the Provide verification details row.
Click Yes to agree to Facebook Platform Policy.
Then, enter instructions that a submission reviewer can follow to verify that your app uses the permissions and features you have requested in the way you have described. You also indicate when this happens in the screencast that you have uploaded.
"To see how our app uses these permissions:
The accompanying screencast shows ads_management being used whenever the user displays ad information or a new entity is saved: for example, at 00:10, 00:18, 00:32, 1:12, and 1:19.”
You have supplied everything a reviewer will need to verify that your app uses the permissions and access levels in an approved manner, so you click Submit For Review.