# The CRM v4 API is deprecated

HubSpot API deprecated /crm/v4/* without giving a shutdown date yet.

HubSpot deprecated the CRM v4 API on May 21, 2026, without specifying an exact shutdown date. This deprecation affects all /crm/v4/* calls, which will eventually fail. HubSpot API noted that in March 2027 the endpoints will transition to an unsupported state and will no longer receive bug fixes or stability guarantees.

## What to use instead

Move to the latest date-based API version, 2026-09, using /crm/associations/2026-09/* and /crm/objects/2026-09/*.

- API: HubSpot API (api.hubapi.com)
- Kind: Version retirement
- Announced: May 21, 2026
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `/crm/v4/*`
- Source: [Announcement](https://developers.hubspot.com/changelog/deprecating-support-for-hubspot-v4-apis)
- Verified: November 6, 2026, against HubSpot API's own pages
- Page: https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-crm-v4-api-is-deprecated/

## HubSpot API's words

> In March 2027, HubSpot v4 APIs will move to an unsupported state. After that date, v4 APIs will no longer receive updates, bug fixes, or stability guarantees from HubSpot.

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