Okapi Okapi

HubSpot API · Version retirement

The Deals API v1 is deprecated

Deprecated, no date

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

What to use instead of these calls

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; it documents them in its March 2027 release.

Calls it hits

  • /deals/v1/*

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.

HubSpot API, Announcement

Facts

API
HubSpot API api.hubapi.com
Kind
Version retirement
Announced
September 15, 2026
Takes effect
No date given yet
Calls after that day
Fail
Source
Announcement
Last updated

More from HubSpot API

Know before your API calls break.

Okapi finds the calls a breaking change hits in your code and opens the pull request that fixes them.

Add to GitHub