Marketing API

Build marketing automation with Facebook's advertising platform. Your app contains any type of functionality you build with Marketing API or other Facebook APIs.

Create an Ads App

New to Facebook ads? Visit Facebook Blueprint. New developers can use Graph Academy, a hands-on, instructional tool.


What's New

Stay up-to-date on Marketing API here! For news on the latest Marketing API version, see Changelog.

Latest Solution Samples
DR Technical Playbook
Essential information you need to build a Marketing Automation system with Facebook's Marketing APIs.
Introduction to Marketing API, Video
Build solutions for marketing automation with Facebook's advertising platform.
Understanding Access Tokens, Video
Types of access tokens: short-lived access tokens, long-lived access tokens, and System User access tokens which last indefinitely
The SMB Guide
For Marketing Partners focused on the SMB vertical design architecture and integrate with the Ads API.
Gaming Best Practices Guide
Marketing Integration best practice for developers in the gaming vertical.

Creating an App with Marketing API

The Ads App flow takes you through all the steps you need to create an ads app. An app is actually a container for any type of Facebook ads functionality you build with Marketing API. Your app can be a proof of concept, scripts to automate marketing, or an app for advertisers to use to run ads. Read on if you want the background:

FAQ

Who should use the Marketing API ?

You may benefit from using the Marketing API if you match one of these profiles:

  • As an advertising management solutions provider, you sell to advertisers or agencies who manage ads on digital properties, including Facebook. You can review our list of current partners, see Facebook Marketing Partners.

  • As an advertiser, you manage your own ad spend, have significant advertising scale specifically on the Facebook platform and require a custom solution that leverages your own internal data.

Before you get started, please review Components of a Successful Integration, which is a checklist to determine the value of building an app on the API and to help you understand the investment needed to be successful.

For most advertisers, building an in-house ads management tool doesn’t make sense due to resource requirements. We recommend using existing Facebook and/or partner tools that fit your needs instead

Does Facebook charge for Marketing API calls?

No. Facebook doesn't currently charge for Marketing API calls.

How can I test the Marketing API?

You can perform your testing in Sandbox Mode. This mode provides a testing environment that helps you create an ad account that is enabled for making Marketing API calls, however it doesn't actually deliver ads. For more information, see Sandbox Mode for Developers.

How do I get access to the Marketing API ?

The API has three levels of access: development, basic and standard. You can get started with the development access level by creating a new app (or use an existing app, if you already have one) and obtaining an access token to start making API calls.

Once you have a successful integration with the Marketing API at the development access level, you can apply for basic access through your app's Status and Review page. Learn more about Marketing API access levels.

Where can I find sample code that uses the Marketing API?

For sample code, please review the API documentation on this site. We also have code samples on Marketing API Accelerator Program.

Who are the tool vendors for the API?

Learn more about tool vendors for the API at Facebook Marketing Partners.