(#2635) You are calling a deprecated version of the Ads API. Please update to the latest version: v{version}.
In short
The app or tool that made the request uses a version of Meta’s Ads (Marketing) API that Meta no longer serves; the message names the version to move to.
By Mathieu Malige, founder of Apogee
· Checked on 8 October 2026
Exact message
| Field | English |
|---|---|
| Message | (#2635) You are calling a deprecated version of the Ads API. Please update to the latest version: v{version}. |
Where it shows up: in the response of Meta’s Marketing API or Graph API (developers, tools and integrations).
Why it happens
- Meta retires old API versions. According to the Marketing API documentation, Meta releases a new version roughly every four months and keeps supporting the previous one for at least 90 days. After that grace period, calls made with the retired version fail, except those Meta upgrades automatically to the next version (this auto-upgrade only applies to endpoints that did not change between the two versions).
- The message gives the target. It ends with the latest version to update to.
- You can see it without coding. If you use a third-party tool, plugin or connector, it is that tool’s version that is out of date, not your ad account.
How to fix it
- If you develop the integration: change the API version in your calls or SDK to the version named in the message, then test.
- If you use a tool or plugin: update it, or contact its vendor, then reconnect it to Meta.
- Retry the action.
What worked for other advertisers
In the GitHub issue of Meta’s Node.js Business SDK on this error, the fix that worked was to force the latest API version right after importing the SDK, by overriding its version constant (FacebookAdsApi.VERSION in Node.js; for the Python SDK, API_VERSION in apiconfig.py), or to update the SDK. 3 confirmations, for example “your fix worked for me in node js.”
Source: GitHub issue #224 of facebook-nodejs-business-sdk
How to avoid it next time
- Track Meta’s versioning page and changelog, and plan an upgrade before your version’s 90-day grace period ends.
- Keep tools and plugins connected to your ad accounts up to date.
Frequently asked questions
Is my ad account blocked?
No. The error is about the API version used by the app or tool making the request.
Which version should I use?
The one named at the end of the message, as Meta’s latest version at that time.
Why does it appear for everyone on the same day?
Because it follows Meta’s version schedule: when a version’s grace period ends, every app still calling it sees its calls fail, except those Meta upgrades automatically to the next version.
Related errors
Launch your creatives in 47 seconds
Bulk upload on Meta Ads, TikTok Ads and Snapchat Ads, with your naming convention detected and Advantage+ off by default. Try the plan of your choice for 7 days for €1, and cancel anytime before day 7, from the app.