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 Bid Strategy New Create API for Collection Ads with Product Sets Facebook Business SDK Solutions to Onboarding Clients at Scale Instagram Stories Ad Formats Dynamic Ads for Automotive Dynamic Ads for Destinations Post Click Configuration Collection ad API	Marketing Developer Blog Defaulting to Flexible Image Aspect Ratio for Image Link Ads on Facebook March 26 at 12:00 PM Stay Informed with Facebook Graph API and Marketing API Updates December 18, 2018 at 12:00 AM Subscribe Now
Recently Updated Docs Dynamic Creative Optimization Mar 28 Asset Feed Spec Mar 27 Placement Asset Customization Mar 27 Segment Asset Customization Mar 27 Dynamic Creative - Quickstart Mar 27 Dynamic Creative Mar 27 App Events API for Collaborative Ads Mar 3 Sample Submission Feb 6 Delivery Insights in Trigger-based Rules Jun 27 Onboard SMB Advertisers to Your Platform at Scale May 21 Setting up your Country and Language catalogs Apr 25 Ad Rules Example - Evaluation Spec Mar 23 Boutique / Franchise Hotel Mar 11 Large Resort / Amusement Park Mar 11 Insights Metrics Estimated and In-Development Feb 16 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
• 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 two levels of access: development 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 standard access through your app's Marketing API Settings page. Learn more about Marketing API access levels.

Who are the tool vendors for the API?

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