Okapi Okapi

HubSpot API /deals/v1/* version retirement

Deprecated, no dateSubscribe to HubSpot APIShare

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.


Calls it hits

  • /deals/v1/*

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 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.

In 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.

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
Verified
, against HubSpot API's own pages

Questions

When does this change take effect?

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

Do these calls still work?

Yes, they still work: HubSpot API has not given a shutdown date yet.

How do I find the calls this hits in my code?

Okapi reads your repository, finds the calls this change hits and opens a pull request with the fix. It never commits to your branches: every change comes as a pull request you review.


More from HubSpot API 10

  1. /crm/v3/extensions/accounting/*Removal Stopped working
  2. /extensions/ecomm/v2/*Removal Stopped working
  3. /calendar/v1/*Removal Stopped working
  4. GET /cms/v3/performance*Removal Stopped working
  5. /hubdb/api/v2/*Version retirement Stopped working
  6. /contacts/v1/lists*Version retirement Stopped working
  7. /v1/*Version retirement Stops workingin 28 days
  8. /crm-pipelines/v1/*Version retirement Stops workingin 28 days
  9. No date /automation/v4/*Version retirement Deprecated, no date
  10. No date /companies/v2/*Version retirement Deprecated, no date

All 8 HubSpot API v1 breaking changes →


Is your code calling this?

Okapi finds the calls this change hits in your repo and opens the pull request with the fix.

Add to GitHub

Get notifications

Subscribe to HubSpot API

Hear about each breaking change HubSpot API announces, in your feed reader, calendar or Slack.

1What to follow

Provider
  • HubSpot API

2Where to get it

/breaking-changes/feed.xml

Paste it into Feedly, Inoreader, NetNewsWire or any reader. New changes show up as they're announced.