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.

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.

Announcements Post Click Configuration Collection ad API Marketing API v2.9 Create Canvas campaigns on Facebook through Marketing API Dynamic Ads Catalog Quality Ad Copy to duplicate your existing ads objects Rules Engine API Post Reactions Reporting for Ads	Marketing Developer Blog Carrying Over Reactions after Editing Ads July 19 at 9:01am Announcing Marketing API 2.10 July 18 at 10:35am Subscribe Now
Latest Solution Samples Custom Audiences Create custom audience January 1, 2016 Creative Combinations Create many ads using combinations of creative elements, links and targeting January 1, 2016 Account List View a list of your ad accounts January 1, 2016 Learn More	Recently Updated Docs Ad Units - Marketing API 7 hours ago Dynamic Ads Management 10 hours ago Dynamic Ads for travel - Catalog Setup Jul 24 Targeting Specs Jul 20 Lookalike Audiences Jul 20 Targeting Audiences Jul 20 Validation Best Practices Jul 20 Ad Targeting Search and Detailed Targeting APIs Jul 20 Insights - Fields Jul 19 Video and Carousel Jul 19 Audience Network Jul 18 Insights - Breakdowns Jul 18 Retrieving Leads Jul 18 Business Manager API Jul 17 Subscribe To Doc Changes
DR Technical Playbook Essential information you need to build a Marketing Automation system with Facebook's Marketing APIs. Download	Introduction to Marketing API, Video Build solutions for marketing automation with Facebook's advertising platform. Watch
Understanding Access Tokens, Video Types of access tokens: short-lived access tokens, long-lived access tokens, and System User access tokens which last indefinitely Watch	The SMB Guide For Marketing Partners focused on the SMB vertical design architecture and integrate with the Ads API. Download
Gaming Best Practices Guide Marketing Integration best practice for developers in the gaming vertical. Download

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:

• Create Ad Account - Use it to manage access to your ads, billing settings, and spending limits. Provide billing information, but you will not be charged until you run an ad.
• Developer Account - Access to our developer tools and enables you to create Facebook apps.
• Get Access Token - You can get a System User access token or a User access token with long-lived expiration with the permissions ads_management or ads_read.
• Create App - Create a Facebook app and get an app ID. You use the ID to make API calls.
• Provide App Settings - Configure your Facebook App for using the Marketing API and other settings.

Tools

Related Resources

• Facebook Marketing Developer Community - Ask your technical questions about Marketing APIs from other developers.
• Facebook Marketing Developers Page - For quick updates on API enhancements and new features.
• Audience Management
• Ads Management
• Ads Insights
• Business Manager API
• Marketing API SDKs
• Marketing API Reference Samples
• Marketing API Accelerator
• API Reference Docs
• Facebook for Business

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.