Using the API

General information on the Marketing APIs, access, versioning and more. The main use cases for the Marketing API are ads insights, audience management, and ads management:

Learn the basic structure and usage of the Marketing API.

  • Access and Authentication - Marketing API has two access tiers: Dev Mode and Standard Access. Each level of access has certain restrictions, described in this article. Set up your dev environment and obtain an access token.
  • Testing - Learn how to test the Marketing API.
  • Graph API - REST-based foundation for Marketing API, how to make all CRUD operations, error handling, and debugging tips.
  • Object Structure - Campaigns, ad sets, ads and ad creatives.

App Review

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.

Businesses Building Tools for Other Businesses

If you are a business building tools for other businesses, you will need to agree to supplemental terms and a Technology Provider amendment, 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 Aug 1st, 2018. If your customers access large scale user data through your tool, we may have additional requirements for them as well.

Building Tools with Marketing API

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.

Versioning

Learn more about upcoming changes and deprecations using our versioning and migration systems.

  • Versioning Overview - Facebook's Marketing API supports versioning cycles for app development stability. Learn more here.
  • Migrations - Future and past Facebook Platform Migrations. Migrations are used to apply changes across all existing versions.
  • Changelog - This changelog covers what's changed in Facebook's Marketing API. These changes include Facebook's server-side APIs and SDKs.