What is the Meta Marketing API?
The Meta Marketing API is Meta's programming interface for automating advertising across its technologies. Software can use it to create campaigns, ad sets and ads, update, pause or delete them, and read performance insights. Its building blocks are campaigns, ad sets, ad creatives and ads. As checked on 2 Oct 2026, its current version is v26.0.
Meta’s developer documentation presents the Marketing API as a way to run advertising from software. A program sends requests to Meta, and Meta builds the ads, changes them or returns their results. This page reflects Meta’s overview page, last updated on 24 June 2026, and the version Meta named as current when checked on 2 Oct 2026: v26.0.
What does the Marketing API let software do?
Meta says you use it to automate advertising across Meta technologies, with functions for ad creation, management and performance analysis. Its overview page lists these jobs:
- Generate campaigns, ad sets and individual ads, then deploy and adjust them based on real-time performance data.
- Update, pause or delete ads.
- Keep campaigns aligned with business objectives.
- Pull detailed insights and analytics to track performance.
Meta adds that automated ad creation lets businesses reach larger audiences while using fewer resources. That is Meta’s description of the purpose, not a result you can expect for your own account.
How is the API organised?
The API uses four objects, and Meta’s overview page describes each one.
| Object | What Meta’s overview says |
|---|---|
| Campaign | The highest-level structure in an ad account; it should represent a single objective, and that objective is validated against every ad you add |
| Ad set | A group of ads that configures the budget and run period; budget, billing and duration apply to all ads in the set |
| Ad creative | Holds only the visual elements of the ad; you can’t change it once it is created, and each ad account has a creative library for reuse |
| Ad | Holds all the information needed to display an ad on Facebook, Instagram, Messenger and WhatsApp, including the creative |
Meta also says all ads in one ad set should share the same targeting and optimization goal, and suggests one ad set per target audience so you control spend per audience. Meta says you can create several ads in each ad set to optimize ad delivery based on different images, links, video, text or placements.
If you already know the campaign, ad set and ad hierarchy from Ads Manager, the objects will look familiar. The one rule to remember before you build anything is that a creative is fixed once made, so you reuse it from the library instead of editing it.
What do you need before the first call?
Meta’s get-started page lists these prerequisites:
- An active ad account, to run campaigns and manage billing.
- A Meta Developer account.
- An app, created in the App Dashboard.
- Authorization, which verifies the users and apps that access the API and grants them permissions.
- Authentication, which covers getting, extending and renewing access tokens.
The same page says your ad account number appears in the ad account Settings in Ads Manager, in the Account overview section. Meta’s authorization page adds that, depending on your intended use case, you may need to submit your app for review to gain access to specific permissions related to ad management. The access tier entry covers that.
How does a request look?
Meta’s versioning page says every Marketing API endpoint is available through a versioned path and shows this general form: https://graph.facebook.com/v{n}/{request-path}. Its example call lists your ad accounts with a version in the path and an access token. Meta also says the API does not accept calls with no version: they fail.
Where do versions, tiers and limits come in?
Each has its own rules and its own page here:
- Versions and deprecations: how long an old version keeps working.
- Access tiers: Limited access and Full access.
- Rate limits: how many calls an ad account can absorb.
Meta’s AI-agent route is a different product: see the Meta ads MCP server.
FAQ
Do you need to write code to use the Marketing API?
Meta’s examples are HTTP requests, such as a curl call to a graph.facebook.com address with an access token. Using the API directly therefore means writing code, or using software that makes those calls for you. To manage ads by hand, Ads Manager remains the interface.
Can you edit an ad creative after you create it?
Meta’s overview says you can’t change an ad creative once it is created. Its route for reuse is the creative library: each ad account has one to store creatives, so the same creative can be used in more than one ad.
How is the Marketing API different from the rest of the Graph API?
Meta’s versioning page says the Marketing API runs on a 90-day deprecation schedule, while the platform API has core and extended versions with a two-year guarantee for core APIs. Its rate limiting page adds that the Marketing API has its own rate limits, separate from Graph API throttling.
Sources
- Marketing API overview (Meta, checked 2 Oct 2026)
- Get started with the Marketing API (Meta, checked 2 Oct 2026)
- Marketing API authorization (Meta, checked 2 Oct 2026)
- Marketing API versioning (Meta, checked 2 Oct 2026)
- Marketing API rate limiting (Meta, checked 2 Oct 2026)
Drafted with AI and checked claim by claim against the pages linked under Sources. Found a mistake? Tell us via the corrections policy.