A new, dated version is released when backward-incompatible changes are made to the API. The current version is 2023-03-25.

Read our API upgrades guide to learn more about backward compatibility. For all API updates, view our API changelog.

All requests use your account API settings, unless you override the API version. The upgrades guide lists every available version. Note that webhook events are structured according to a specific version of events.

To set the API version on a specific request, send a X-Version header.