HubSpot Developer Changelog

Advanced auth and scope settings for public apps

Live: October 21, 2024

Today we're releasing an update to the auth settings for public apps. This update will add new options for choosing the scopes used by your app. The new settings are currently optional, but they will be required beginning on October 21.

March 2024 Rollup

Announced: April 1, 2024

March brings new HubL features for the HubSpot CMS, pinning engagements using the CRM API, new reporting for associations, expanded limits for CRM exports, and a new component for custom UI extensions.

Restricting the inboxId query parameter in the Beta Conversations API

Live: January 31, 2024

We'll be limiting requests to the GET /conversations/v3/conversations/threads endpoint to allow only a single inboxId query parameter.

Changes to primary labels for HubSpot-defined association labels

Announced: December 15, 2023

We're changing the labels for some of the HubSpot-defined associations between companies and other CRM objects.

Updated recommendations for storing OAuth access tokens

Announced: December 15, 2023

We're updating our recommendation for storing access tokens to allow tokens to be at least 512 characters in length.

Update to Forms API v3 and the lifecycle stage

Announced: December 12, 2023

This post serves as an update to the previous post on the lifecycle stage in forms. This post covers the details for the Forms API v3, which were missing from the previous post.

Increasing the size of contact record IDs

Announced: December 7, 2023

Beginning in March 2024, we'll be updating the system that generates contact record IDs. This will affect the id for the v3 Contacts API, the vid for the legacy Contacts API, and the hs_object_id property returned with either API.

October 2023 Rollup

Announced: October 31, 2023

October brings us webhooks for private apps, multiple updates to the HubSpot CMS, and updates for UI Extensions using React.

New permission requirements for installing public apps

Announced: October 4, 2023

What's changing? Beginning on Monday, October 16th, the App Marketplace Access permission will be required for the first install of any public app. This change will affect any HubSpot user installing any public app, when the app has not been...

Changes to the lifecycle stage in forms

Live: March 19, 2024

Note: This post has been updated to reflect the new date that the changes will go live. The changes to the legacy v2 Forms API will now go into effect on March 19, 2024. For the changes to the beta v3 Forms API, please see this separate post. We're...

Sunset of JWT SSO Setup for Private Content

Live: January 29, 2025

What's Changing? On January 29th, 2025 we are deprecating the ability to set up Single Sign-On (SSO) for JWT-based applications. Moving forward, we will be replacing this functionality with the OpenID Connect (OIDC) standard1. If you are already...

Breaking Change: Upcoming Change to Scope Requirements for App Cards in Private Apps

Live: December 1, 2024

As part of our ongoing efforts to enhance security within the HubSpot ecosystem, we will update the scope requirements for app cards in private apps on December 1st, 2024.

Breaking Change: Removed Support for Referencing Custom Object Types by Base Name

Live: April 29, 2025

We are removing the undocumented support for requesting custom object types by their base name (GET/crm/v3/objects/{baseName}) in HubSpot public APIs. All custom object types must be referenced by their unique identifier (object type ID, fully...

Public Beta: Automatic Deactivation of Exposed Tokens

Live: April 7, 2025

To enhance the security of our platform and protect our customers, we are introducing an automatic token deactivation public beta feature on October 8th, 2024, for any HubSpot tokens publicly exposed in GitHub repositories. This update is designed...

Updated Merge Functionality for CRM Objects (including Contacts and Companies)

Live: January 14, 2025

Note: This changelog supersedes a prior version published on July 22, 2024. Due to customer feedback and confusion regarding the scope of changes, we have updated and clarified the details in this new changelog. Please review the updated information...

Bug Fix: Batch Read Limit for HubSpot Associations API

Live: January 6, 2025

HubSpot is introducing a new limit on the number of IDs that can be supplied to the Batch Read endpoint for (/{fromObjectType}/{toObjectType}/batch/read) both the v3 and v4 public Associations API.

Updated merge functionality for contacts and companies

Live: January 14, 2025

Note: This changelog has been superseded by an updated version published on October 2, 2024. Please refer to the new changelog for the most accurate and up-to-date information regarding merge functionality for contacts, companies, and other CRM...

Breaking Change: Enhanced Validations for Non-String Properties in HubSpot's CRMObject APIs

Live: January 6, 2025

Starting January 6, 2025, HubSpot will implement enhanced validations for non-string property values, including enumeration and multi-value enumeration property values submitted via the CRMObject APIs. This change aims to improve data integrity and...

Update: Legacy CTA Sunset

Live: March 31, 2025

Based on community feedback, we have updated our approach to transitioning from Legacy CTAs to the new CTA editor in HubSpot. In Q1 2025, new CTAs cannot be created by the Legacy CTA editor. Below are more details explaining the plan and changes to...

Upcoming Sunset: V1 Contact Lists API

Live: May 30, 2025

What’s changing? The V1 Contact Lists API will sunset on May 30th, 2025. After this date, calls made to the v1 endpoints will no longer function. We're sunsetting the V1 Contact Lists API to focus our development efforts on the improved V3 Lists...

Legacy v1 Integration Timeline API Update

Live: December 2, 2024

We are making an important update to ensure our platform remains cutting-edge and to facilitate the introduction of new features. Starting December 2, 2024, the legacy v1 Integration Timeline API will no longer support mutations of Timeline Events....

Legacy CTA Sunset Timeline and Scope Update

Live: December 31, 2024

Previous Sunset Start: April 30, 2024