What Is the Status of Meta Marketing API v24.0 as of 9 October 2026?
Its listed end date has passed. As of 9 October 2026, the "Available Marketing API versions" table on Meta's Marketing API changelog shows v24.0, introduced 8 October 2025, as available until 6 October 2026. The same table shows v25.0 and v26.0 with end dates of TBD, and Meta's versioning page states that "the current version of the Marketing API is v26.0". The Graph API changelog's own Marketing API table gives the same three rows, so on this point Meta's pages now agree.
What happens to a call that still targets v24.0 depends on the endpoint. Meta's versioning documentation says that once a version is unavailable, "any calls made to that version number may fail or be upgraded to the next available version." Some integrations will therefore have broken loudly, and others will have kept working while being moved onto a newer version you never tested against. The second case is the one teams miss.
| Marketing API version | Introduced | Available until (as listed 9 October 2026) |
|---|---|---|
| v26.0 (current) | 29 July 2026 | TBD |
| v25.0 | 18 February 2026 | TBD |
| v24.0 | 8 October 2025 | 6 October 2026 (passed) |
| v23.0 | 29 May 2025 | Ended 9 June 2026 |
Which Meta API Versions Have Expired, and Which Are Next, in 2026?
Meta publishes two different version tables, and they do not say the same thing. The Marketing API changelog lists "Available Marketing API versions" with v24.0 available until 6 October 2026. The Graph API changelog lists the same version numbers with much longer windows, including v24.0 available until 18 February 2028. Meta's own versioning guide explains why: "The Marketing API has its own versioning scheme," and both version numbers and schedules differ from the Graph API's.
For anyone running ads through scripts, connectors, reporting tools or a third-party platform, that distinction is the whole story. The Graph API dates are the ones most widely repeated. The Marketing API dates are the ones that govern advertising endpoints, and on Meta's own Marketing API page the next one falls on 6 October 2026, four days after this guide was published.
| Version | Marketing API changelog: available until | Graph API changelog: available until |
|---|---|---|
| v26.0 | Not listed | Released 29 July 2026, end date TBD |
| v25.0 | Released 18 February 2026, end date TBD | 29 July 2028 |
| v24.0 | 6 October 2026 | 18 February 2028 |
| v23.0 | 9 June 2026 (already passed) | 8 October 2027 |
| v22.0 | Not listed | 20 May 2027 |
| v21.0 | Not listed | 21 January 2027 |
| v20.0 | Not listed | 24 September 2026 (already passed) |
When this guide was first published on 2 October 2026, the Marketing API changelog's most recent dated entry was 05/04/2026, which raised the question of whether its version table was current. As of 9 October 2026 the version table on that page lists v26.0, introduced 29 July 2026, and matches the Marketing API table on the Graph API changelog, so both now give 6 October 2026 for v24.0. As always, confirm the state of your own app in its dashboard rather than in any blog post, including this one.
Why Does the Marketing API Schedule Matter More Than the Graph API One?
Because the two schedules are built on different promises. Meta's Graph API versioning guide says "each version will remain for at least 2 years from release." Meta's Marketing API versioning documentation describes a shorter commitment: when a new Marketing API version is released, the previous version is supported "for at least 90 days." A team that assumes the two-year Graph window applies to its ad integrations is planning on the wrong clock.
- Reporting pipelines: dashboards that pull ad performance through the Marketing API break silently when a version expires, often noticed only when a client asks why numbers stopped.
- Campaign automation: scripts that create or edit campaigns stop working, or behave differently after an upgrade.
- Third-party tools: many teams do not know which version their tools call. The tool vendor owns the upgrade, but the client owns the outage.
- Agency operations: an agency running many accounts through one integration has every client exposed to the same date.
What Happens When a Meta API Version Expires in 2026?
Meta's two documents describe different behaviour, and both are worth knowing. The Graph API versioning guide says that once a version is no longer usable, "any calls made to it will be defaulted to the next oldest, usable version." The Marketing API versioning documentation describes a 90-day grace period, after which "the deprecated version stops working", and says calls to an unavailable version "may fail or be upgraded to the next available version."
"May fail or be upgraded" is the line to plan around. An upgrade sounds safe, but a call silently moved to a newer version can return fields differently or reject parameters the old version accepted. For anything that matters, an explicit upgrade that you have tested is safer than relying on Meta's fallback.
How Does Marketing API Version Auto-Upgrade Work in 2026?
Meta's Marketing API documentation describes auto-version upgrade as applying when an endpoint is not affected by a version change: in that case "the platform will upgrade the call to the next available version." It can be switched off: "You can disable the version auto-upgrade via the Marketing API Version setting under Marketing API App Product Page > Settings."
The dates Meta gives for this feature are inconsistent across its pages. The Marketing API versioning documentation says "Starting May 2024, Meta enables the auto-version upgrade feature for Marketing API endpoints." The Graph API changelog says "Marketing API version auto-upgrade will be released on July 29, 2026." Whichever is current, the practical rule is the same: auto-upgrade only covers endpoints that a version change does not affect, so it is a safety net for unchanged calls, not a substitute for upgrading the calls that did change.
| Question | What Meta's documentation says |
|---|---|
| Does auto-upgrade cover every endpoint? | No. It applies "if an endpoint is not affected" by the version change. |
| Can I turn it off? | Yes, in the Marketing API Version setting under Marketing API App Product Page > Settings. |
| When did it start? | Pages differ: May 2024 on the Marketing API versioning page; 29 July 2026 on the Graph API changelog. |
| How long is the previous version supported? | "At least 90 days" after a new Marketing API version is released. |
How Do You Check Which Meta API Version Your Tools Use in 2026?
Look at the version in the request path, then confirm in your app's settings. Meta's versioning guide shows that Graph and Marketing API calls carry the version in the URL, for example https://graph.facebook.com/v26.0/{endpoint}, and that SDKs set it in code: the JavaScript SDK uses the version parameter in FB.init(), and the Android SDK uses GraphRequest.setVersion().
- Search your own code and scripts for
graph.facebook.com/vand note every version number in use. - Check SDK configuration for the version parameter, since a pinned SDK version can hold you on an old API version.
- Ask each third-party vendor in writing which Marketing API version their integration calls and when they will upgrade past v24.0.
- Open the Marketing API App Product Page settings and confirm the version and auto-upgrade setting there.
- Test on a non-critical account first after upgrading, and compare report outputs before and after.
What Should Agencies Do Now in 2026?
Find every integration on Marketing API v24.0 or earlier and upgrade it to v26.0, or get a written date from the vendor that owns it. v24.0's listed end date of 6 October 2026 has passed, so any remaining exposure is now either failing or running on an auto-upgraded version you did not choose. Finding it costs an afternoon; finding it through a client asking why their report is wrong costs considerably more.
| Who | Action in 2026 |
|---|---|
| In-house team with scripts | Search code for version numbers; upgrade and test anything on v24.0 or older |
| Agency on a third-party tool | Ask the vendor which version they call and their upgrade date |
| Agency with its own integration | Upgrade to a current version, test on one account, then roll out |
| Anyone relying on auto-upgrade | Remember it only covers unaffected endpoints; test the affected ones |
Two other Meta changes this month are worth reading alongside this one. Meta's Creator Marketing Hub update expanded the creator APIs, and the wider campaign structure is covered in our Meta Ads complete guide for 2026. For the Google side of the same problem, see our Google Ads API v22 sunset guide, whose date was 7 October 2026.
How Do You Tell Whether a Meta Call Failed or Was Auto-Upgraded in 2026?
Check the response headers, then check behaviour. Meta's documentation says that an API call targeting a deprecated version that has been automatically upgraded includes a notification header, which Meta shows as X-Ad-Api-Version-Warning, stating that the call has been auto-upgraded to a newer version. A call that failed outright returns an error instead. The two need different responses.
- Look for the symptoms. Reporting that stopped refreshing on or after 6 October 2026, a sync or ad-management job showing errors, conversion data that stopped arriving, or, more subtly, a tool that still works but returns fields or values that look different from before.
- Read the headers. If your logs or tool expose response headers, search for
X-Ad-Api-Version-Warning. Its presence means Meta upgraded the call for you, and the integration is now running on a version it was not built against. - If calls are failing, upgrade. Move the integration to v26.0, the current Marketing API version, and test the endpoints you actually use before rolling out to every ad account.
- If calls were auto-upgraded, still upgrade deliberately. Auto-upgrade only applies where Meta judges an endpoint unaffected, so it is a safety net rather than a migration. Set the version explicitly and test, so the next change does not happen to you silently.
- Decide whether you want auto-upgrade at all. Meta's documentation says it can be disabled via the Marketing API version setting under Marketing API, App Product Page, Settings. Some teams prefer a clean failure they can see to a silent change they cannot.
- If a vendor owns the tool, ask in writing which Marketing API version it calls, whether its calls were auto-upgraded, and when it will move to v26.0.
What Are the Common Mistakes With Meta API Versions in 2026?
- Planning ad integrations on Graph API dates. Meta says the Marketing API has its own versioning scheme and schedule.
- Assuming the two-year window applies. Marketing API support after a new release is "at least 90 days".
- Relying on auto-upgrade for everything. It applies only where an endpoint is not affected.
- Not asking vendors. If a tool calls the API for you, its version is your risk.
- Trusting any single table blindly. Meta's two changelogs disagree and one may be out of date. Confirm in your app settings.
- Upgrading without comparing reports. A newer version can return data differently. Check outputs before and after.
Key Takeaways for 2026
- Meta Marketing API v24.0 reached its listed end date on 6 October 2026, and v23.0 ended on 9 June 2026. v26.0 is the current version, with v25.0 and v26.0 end dates TBD.
- The Graph API changelog lists far longer windows for the same numbers, such as v24.0 until 18 February 2028. Meta says the two schedules differ.
- Marketing API support after a new release is "at least 90 days"; Graph API versions last "at least 2 years from release".
- Auto-upgrade covers only unaffected endpoints and can be disabled in the Marketing API App Product Page settings.
- Meta's pages give different start dates for auto-upgrade: May 2024 and 29 July 2026.
- This week: search code for version numbers, ask every vendor, and confirm in your app dashboard.
Distk helps teams in India and internationally audit the scripts, connectors and tools that touch their ad accounts, so version changes on Meta and Google never surface as a broken report. If you are not sure which API versions your stack calls in 2026, that audit is where we start.
Sources
- Meta for Developers, Marketing API changelog (available Marketing API versions table).
- Meta for Developers, Graph API changelog (version table and the auto-upgrade release note).
- Meta for Developers, Graph API versioning guide.
- Meta for Developers, Marketing API versioning.