# The Deals API v1 is deprecated

HubSpot API deprecated /deals/v1/* without giving a shutdown date yet.

HubSpot deprecated /deals/v1/* without a shutdown date. Endpoints with numbered paths will move to unsupported status without bug fixes, reliability improvements, or security updates. Calls to these endpoints will eventually fail.

## What to use instead

Move to the Deals API on date-based versioning (/crm/objects/2026-09/deals). HubSpot has not finalized every legacy endpoint's date-based replacement yet and documents them in its March 2027 release.

HubSpot has not finalized every legacy endpoint's date-based replacement yet; it documents them in its March 2027 release.

- API: HubSpot API (api.hubapi.com)
- Kind: Version retirement
- Announced: September 15, 2026
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `/deals/v1/*`
- Source: [Announcement](https://developers.hubspot.com/changelog/legacy-apis-and-legacy-apps-whats-going-unsupported-and-when)
- Verified: November 6, 2026, against HubSpot API's own pages
- Page: https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-deals-api-v1-is-deprecated/

## HubSpot API's words

> Endpoints using numbered version paths, /v1/ , /v2/ , and /v3/ , will move to unsupported status. HubSpot will no longer release bug fixes, reliability improvements, or security updates for these versions.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent