Deprecating Support for HubSpot v4 APIs

Developer Support Developer Announcements
,
1

On March 30, 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.

What’s changing?

As part of HubSpot’s transition to date-based versioning (announced in March 2026), the legacy semantic API version v4 is moving out of support. The legacy semantic API version v4 is being phased out in favor of the current date-based versions.

This means:

  • v4 APIs will become unsupported on March 30, 2027.
  • Unsupported versions may continue to function for some period of time, but they are not guaranteed to remain stable or available.
  • Apps and integrations that continue relying on unsupported v4 APIs may experience degraded performance or outages.

What does this mean for developers?

If your app or integration currently uses v4 APIs (e.g., /crm/v4/), you should plan to migrate to the latest date-based versioned API before March 30, 2027. The current recommended target is API version 2026-03.

To prepare:

  • Inventory any applications, integrations, or internal tooling that still call v4 APIs.
  • Update those integrations to use a supported date-based API version.
  • Validate and roll out the new version before the end-of-support date to avoid disruption.

For Marketplace apps, this also affects certification and recertification. Apps using unsupported API versions that no longer meet the latest requirements may be denied certification or recertification, and non-functional apps may be removed from the HubSpot Marketplace.

Why is HubSpot making this change?

This change is part of HubSpot’s broader shift to date-based API versioning, which is designed to give developers clearer version boundaries, more predictable support timelines, and a more consistent upgrade path. It also helps reduce unexpected changes for end users by making version adoption more explicit and intentional.

When is it happening?

The end-of-support date for v4 APIs is March 30, 2027. We strongly recommend completing your API migration before that date.

Helpful resources

Questions or comments? If you need help understanding HubSpot’s date-based versioning model or planning your migration, review the resources above and follow future updates in the HubSpot Developer Changelog.

2

Can you please clarify the date that v2 and v3 endpoints will be deprecated?

3

@AndrewGallacher - Great question! The current v1-v3 APIs will continue to work, and the support timeline will be announced later on. However, all APIs will transition to date-based versioning, so any semantic versions currently in use should eventually be scheduled to transition.

4

@hseligson Thanks for your prompt response. I know I need to change all v1-v3 API calls. My question is, when! Will v1-v3 stop working before March 2027 or after March 2027? When will that date be announced. I am responsible for an integration hub that makes multiple calls to the HubSpot API - mostly v3 - and I need to know when I need to make this change and schedule it in amongst the many other internal demands for work from my organisation.

5

@hseligson Thanks for your prompt response. I know I need to change all v1-v3 API calls. My question is, when! Will v1-v3 stop working before March 2027 or after March 2027? When will that date be announced. I am responsible for an integration hub that makes multiple calls to the HubSpot API - mostly v3 - and I need to know when I need to make this change and schedule it in amongst the many other internal demands for work from my organisation.