Paid Media Guide

Meta Marketing API v24.0 Expired on 6 October 2026: Failures, Auto-Upgrades and the Fix

The end date Meta published for Marketing API v24.0 has passed. Calls to it may now fail, or may be quietly upgraded to a newer version, and the two outcomes need different fixes. Updated 9 October 2026 with the current version tables and how to tell which one happened to you.

Distk Editorial Oct 2026 10 min read

Meta Marketing API v24.0 reached its listed end date on 6 October 2026. As of 9 October 2026, Meta's Marketing API version table lists v24.0 as available until 6 October 2026, with v25.0 and v26.0 both marked TBD and v26.0 as the current version. Meta's versioning documentation says that once a version is unavailable, calls to it "may fail or be upgraded to the next available version": auto-upgrade applies only to endpoints unaffected by the version change, and an auto-upgraded call carries the response header X-Ad-Api-Version-Warning. Auto-upgrade can be switched off in the Marketing API settings of your app. The Graph API has a separate, longer schedule that lists v24.0 until 18 February 2028, which is why the dates repeated online often disagree. Anything you run on Marketing API v24.0 or earlier should be upgraded to v26.0 now, and any vendor tool should give you a written confirmation of its version.

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 versionIntroducedAvailable until (as listed 9 October 2026)
v26.0 (current)29 July 2026TBD
v25.018 February 2026TBD
v24.08 October 20256 October 2026 (passed)
v23.029 May 2025Ended 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.

VersionMarketing API changelog: available untilGraph API changelog: available until
v26.0Not listedReleased 29 July 2026, end date TBD
v25.0Released 18 February 2026, end date TBD29 July 2028
v24.06 October 202618 February 2028
v23.09 June 2026 (already passed)8 October 2027
v22.0Not listed20 May 2027
v21.0Not listed21 January 2027
v20.0Not listed24 September 2026 (already passed)
Read this before you plan against either table in 2026

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.

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.

QuestionWhat 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().

  1. Search your own code and scripts for graph.facebook.com/v and note every version number in use.
  2. Check SDK configuration for the version parameter, since a pinned SDK version can hold you on an old API version.
  3. Ask each third-party vendor in writing which Marketing API version their integration calls and when they will upgrade past v24.0.
  4. Open the Marketing API App Product Page settings and confirm the version and auto-upgrade setting there.
  5. 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.

WhoAction in 2026
In-house team with scriptsSearch code for version numbers; upgrade and test anything on v24.0 or older
Agency on a third-party toolAsk the vendor which version they call and their upgrade date
Agency with its own integrationUpgrade to a current version, test on one account, then roll out
Anyone relying on auto-upgradeRemember 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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?

Key Takeaways for 2026

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 Marketing API Versions in 2026: FAQs

When did Meta Marketing API v24.0 expire?

Meta's Marketing API version table lists v24.0 as available until 6 October 2026, a date that has now passed; calls to it may fail or be auto-upgraded. The Graph API lists v24.0 until 18 February 2028 because the two APIs have separate schedules. Move to v26.0, the current version.

Why do the Marketing API and Graph API show different dates?

Meta's versioning guide states that the Marketing API has its own versioning scheme, and that both version numbers and schedules differ from the Graph API's.

How long does Meta support an old Marketing API version?

Meta's Marketing API documentation says the previous version is supported for at least 90 days after a new version is released. Graph API versions remain for at least two years from release.

What happens if my tool calls an expired version?

Meta's Marketing API documentation says calls to an unavailable version may fail or be upgraded to the next available version. An upgraded call can behave differently, so test explicitly rather than relying on the fallback.

How does Marketing API auto-upgrade work?

Meta upgrades a call to the next available version only if the endpoint is not affected by the version change. You can disable it in the Marketing API Version setting under Marketing API App Product Page, Settings.

How do I check which Meta API version my tools use?

Look for the version in request paths such as graph.facebook.com/v26.0, check SDK version settings, ask each third-party vendor in writing, and confirm in your Marketing API app settings.

Find every integration still on an old version

Distk audits the scripts, connectors and tools that touch your Meta and Google ad accounts, finds anything failing or silently auto-upgraded after this month's version changes, and moves it to a version you have actually tested.

Start the conversation →