Which Meta API Versions Expire 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) |
The Marketing API changelog's version table and its most recent dated entry, 05/04/2026, predate the v26.0 release that the Graph API changelog lists on 29 July 2026, so that page may not reflect every version change since. The safe position is to treat 6 October 2026 as the deadline for anything calling Marketing API v24.0 or earlier, and to confirm the current state in your app's dashboard rather than in a 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 This Week in 2026?
Find every integration on Marketing API v24.0 or earlier and either upgrade it or get a written date from the vendor that owns it. The Marketing API changelog puts v24.0's end at 6 October 2026. Even if a later Meta update extends that date, finding your exposure now costs an afternoon and finding it after an outage costs a client conversation.
| 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, which falls on 7 October 2026.
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's Marketing API changelog lists v24.0 as available until 6 October 2026; v23.0 already ended on 9 June 2026.
- 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.