Skip to content
HubSpot Developer Changelog

Upcoming Sunset: HubDB v1 API, HubDB v2 API, and HubDB JavaScript Client

On Jan 31, 2024, we will be sunsetting the following items in relation to HubDB:

We encourage users to migrate the HubDB v3 API. This API includes many performance, usability, and API consistency improvements over the v1 and v2 API. This includes:

  • Tables are required to have both a name and label.
  • Support for both table id and name in the url paths.
  • GET row endpoints return column name instead of id in the values field. Also, POST, PUT, and PATCH row endpoints require column name instead of id in values field.
  • Row update PATCH endpoints now accept sparse updates, which allows you to specify only the column values that you need to update, unlike the previous version where you had to specify all the column values.
  • Removed the  GET, UPDATE, and DELETE endpoints for a single cell in a row in favor of the row update PATCH endpoints.
  • Import endpoint now supports an optional field idSourceColumn to make it easier to update existing rows, along with existing fields in the JSON-formatted options. 
  • Clone endpoint requires a new name and new label.

Read more about our HubDB v3 API, view examples, and begin planning your migration to the new version.

Discuss this change on our community post here.