API sunsets · Google · checked
Google Ads API v23 sunset in February 2027
Google Ads API v23 is sunset in February 2027 (Google gives the month, not the day). After it, every request to it fails with an error. The failure is loud: calls return errors. Google names v25 as the replacement (the latest released version on 8 October 2026; v26 is listed for October 2026). Record your real calls on v23 before the date and replay them on v25: after it, nobody can record what v23 returned. Find every place your code pins v23: npx --allow-git=root github:agentwares/api-sunset scan
$ npx --allow-git=root github:agentwares/api-sunset scan
npx --allow-git=root github:agentwares/api-sunset scan lists every API version your code and config pin (Shopify, Meta Graph, Google Ads, HubSpot, Stripe and the rest of this list) with its end date, what breaks and this page's link. It needs no account and no API key, reads your files on your machine and sends nothing; its one request fetches this data. Free and MIT licensed.
The facts
- API
- Google Ads APICovers the Google Ads API and its client libraries.
- Version
v23Released 28 January 2026.- Ends
- February 2027Google gives the month, not the day.
- After the date
- calls fail
- Silent?
- No: calls return errors
- Replacement
v25the latest released version on 8 October 2026; v26 is listed for October 2026
What breaks after Feb 2027
- The sunset version can no longer be used. Requests sent to this version will fail on or after the sunset date; the Google Ads API throws an error if you try to access the endpoints of a sunset version. source
- Google gives the month, not a day; the count of days left runs to the first of the month.
- v23.1 and v23.2 are listed until February 2027 too.
- Minor versions use the major version's endpoint: your endpoint changes only when you change major versions.
How to upgrade
- Find every place your code and config pin v23:
npx --allow-git=root github:agentwares/api-sunset scanprints each file and line, and the variable name for a.envfile, never its value. - Read what changed between v23 and
v25in Google's notes, and list the calls that touch it. - Before February 2027, send your real calls to v23 and to v25 and compare the answers: same status, same fields, same values where they should match; after it, nobody can record what v23 returned.
- Change the version string, deploy, and watch the first day's responses.
Record your real calls on the old version before the date, and replay them on the new one.
agentcheck runs scheduled checks of an endpoint. A check sends the request you define (a path or a full URL, a method and a body, with your API key as a header, stored encrypted) on a schedule and compares each response with a golden: exact text, contains, a regular expression or a JSON Schema, none of which costs an LLM call. When a response stops matching, it opens an incident and alerts you. Point one check at v23 and one at v25 with the same golden, and you see which of your calls answer differently before February 2027.
Free: 1 monitored target, hourly checks, badge and public status page. Starter: 3 targets, 5-minute checks, Slack and Discord alerts, 30-day history. Recording the calls your code already makes is a different path: the trace import (POST /api/v1/targets/{id}/traces, or the agentcheck_record MCP tool) takes agent traces, a prompt and an answer, and turns them into checks judged by the LLM judge (Pro). It does not take raw HTTP requests and responses, so for an API the scheduled checks are the way in today.
Migration watch is not built. It would record the calls your code makes to Google Ads API v23 and replay them on v25 until February 2027, with nothing to set up, and email you what answers differently. If you would pay for that, say so with one click. The click is counted; nothing else is sent or stored.
Counted. Thank you; nothing else was sent.Other Google dates
- Google Ads API v22 — Oct 2026
- Google Ads API v24 — May 2027
- Google Ads API v25 — Aug 2027
- Google Content API for Shopping v2.1 — 18 Aug 2026 (past)
Sources
- Google Ads API: deprecation and sunset — the date and the replacement, read 8 Oct 2026
Built only from Google's own pages. No intent is implied: a date is what the page says on the day it was read. Data: /apis/sunsets.json.
api-sunset is a free tool from agentcheck, which runs scheduled checks of your endpoints and alerts you when an answer changes.