API Information

General information about using the Marketing APIs, get access, versioning and more.

Using the API

The main use cases for the Marketing API are insights, audience management, and full ads management. Check out the appropriate getting started docs, guides, and references:

Ads Insights API: access your ad performance data for use in custom dashboards and data analytics

Getting started on the Ads Insights API
Insights API Reference

Audience Management API: manage your first party data, find new customers, and reengage existing customers through Custom Audience targeting on Facebook

Getting started on the Audience Management API
Custom Audiences Reference

Ads Management API: The full suite of APIs, from ad creation and management, reporting, and audience management

Getting started on the Ads Management API
Ads Management API Guides

General Information

Learn about the basic structure and usage of the Marketing API.

Access
The Marketing API has three levels of access: development, basic, and standard access levels. Each level of access has certain restrictions, described in this article.

Authentication
Set up your dev environment and obtain an access token.

Testing
Learn how to test the Marketing API.

Using the Graph API
Review of the Graph API, covering the architecture of the API, how to make all CRUD operations, error handling, and debugging tips.

Object Structure
Learn about campaigns, ad sets, ads and ad creatives.

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 about timelines and current versions here.

Migrations
This document covers 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.

Upgrade Guide
This guide goes into more details about the individual changes in each version and helps you upgrade your apps across versions.