HubDB API Version 2

hubdb

#1

What’s happening?

Now live, new Version 2 endpoints are being released for the HubDB API. The V2 API supports a draft version of each table to better support testing and/or change review processes. The existing HubDB API endpoints will continue to function as usual to maintain backwards compatibility.

What’s changing?

With the release of the HubDB v2 API, tables now support a draft version. This will allow you to update data in the table, either for testing or to allow for a manual approval process, without affecting any live pages using the data in the table. Draft data can be reviewed and then published by a user working in HubSpot, or published via the API. The draft data can also be discarded, allowing users to go back to the current live version of the data without affecting the live data.

Changes:

  • All version references are updating from v1 to v2
  • Two new endpoints are being released:
    • Publish/republish the draft table:
      • PUT /hubdb/api/v2/tables/:tableId/publish
    • Revert the draft table to the last published version:
      • PUT /hubdb/api/v2/tables/:tableId/revert

When is this happening?

This feature is currently live; integrators can take advantage of the V2 API immediately. The existing HubDB API endpoints will continue to function as usual to maintain backwards compatibility.

Please don’t hesitate to post any questions or concerns in the comments below.