HubSpot Developer Changelog

The profile-token value is being removed from Contact API responses

Live: March 15, 2021

On March 15, 2021, the Contact API endpoints will no longer return the profile-token value. This value was part of the public contact record functionality that was sunset in early 2019. Note that the related redirect...

Announcing the removal of hs_discount_display_style from the Quotes API

Live: February 15, 2021

On February 15, 2021, we will be removing the hs_discount_display_style value from all Quote API request and response body definitions. This is a property that wasn’t documented on the developer website, but has been returned until now (and will be...

Announcing a change to how CRM object property creation is validated in v3 endpoints

Live: February 1, 2021

When creating new properties for CRM objects via the HubSpot APIs, both a type and fieldType value are required. The type value is used to determine what data can be stored in the property, while the fieldType value is used to determine how the...

Announcing Developer Identity for Unlisted HubSpot Apps

Announced: October 22, 2020

Trust is a core part of the HubSpot platform and identity plays a key role. Users want to verify whether they can trust each app developer with their business data. Starting today, developers will be able to identify themselves and their apps to...

Announcing a change of behavior for the “prev” paging response value

Live: January 25, 2021

When returning a large amount of data, HubSpot endpoints frequently employ a paging mechanism, where a subset of the response data is returned, along with a paging object. This object contains information about how to get new pages of information....

Announcing the new Feedback Submissions API

Announced: October 8, 2020

Today we’re pleased to announce the public beta of our new Feedback Submissions API. With this API, you’ll be able to get information about existing responses to HubSpot surveys. The API does not currently support creating new feedback submission...

Announcing a new definition for the archivedAt endpoint response value

Announced: October 7, 2020

We want to share that the archivedAt API response value has a new definition for most endpoints. Previously, a bug caused archivedAt to return a timestamp showing when the object was last modified. Recently we began instead to return the timestamp...

Announcing the ability to define custom objects in apps

Announced: October 5, 2020

Last week, we announced custom objects on HubSpot, along with API support for custom object schemas and the ability to create, read, and update instances of custom objects. At the time, creating a custom object schema (that is, defining a new custom...

Announcing Custom Objects and the Custom Object API

Announced: September 22, 2020

Today we’re thrilled to announce that custom objects are live and available for all Enterprise accounts. You can now create objects that are specifically tailored to your use case. For example, create a real estate Listing object and associate...

Visitor Identification API goes to GA

Announced: September 21, 2020

We’re excited to announce that our Visitor Identification API is going from beta to general availability. With this change, you can now confidently start building integrations with this API. Thanks for all the feedback you passed along during the...

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