Supported Shopify API versions
Cloudhooks tracks the Shopify Admin API version lifecycle so your hooks keep working. Shopify supports the four most recent quarterly API versions — a rolling one-year window — and retires the oldest each quarter. Cloudhooks monitors this and raises its lowest-supported version to match.
Current lowest-supported version:
2026-01(as of September 2026). Before a version is upgraded, test your hook against the new version to catch any schema changes.
Lowest-supported version history
Each date below is when Cloudhooks raised its floor to the version shown — roughly two weeks before Shopify's own deprecation date (the first of the following month). As a Shopify app, Cloudhooks has to demonstrate about two weeks of clean operation on currently-supported API versions ahead of each deadline to stay compliant and avoid enforcement from Shopify, so it moves proactively rather than waiting for the cut-off.
| Shopify API version | Became the lowest-supported on |
|---|---|
2026-01 | September 15, 2026 |
2025-10 | June 14, 2026 |
2025-07 | March 17, 2026 |
2025-04 | December 14, 2025 |
2025-01 | September 15, 2025 |
2024-10 | June 16, 2025 |
2024-07 | March 14, 2025 |
2024-04 | December 14, 2024 |
2024-01 | September 14, 2024 |
2023-10 | June 14, 2024 |
2023-07 | March 14, 2024 |
2023-04 | December 14, 2023 |
2023-01 | September 14, 2023 |
2022-10 | June 14, 2023 |
How this affects your hooks
Cloudhooks calls Shopify using its built-in clients on a supported API version. When Shopify deprecates a version, we announce the new floor in the changelog and notify you about any of your hooks still pinned to a deprecated version.
If you don't upgrade those hooks yourself before the deadline, Cloudhooks upgrades the hook's API version automatically so it keeps running against a supported version. This resolves the deprecation itself, but it does not guarantee the hook still behaves correctly — a newer API version can introduce incompatible changes to schemas and responses.
For that reason, the safe path is to upgrade your hooks yourself: review Shopify's breaking-change notes and test the hook against the new version before the automatic upgrade would take over.