There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API keys are no longer a supported authentication method for accessing HubSpot APIs. Instead, you should use a private app access token or OAuth to authenticate API calls. Learn more about this change and how to migrate an API key integration to use a private app instead.

Get details for a specific table

Last updated January 31, 2024

GET /hubdb/api/v2/tables/:tableId

Please note: as of January 31, 2024, the HubDB v2 API has been sunsetted. The associated endpoints will not be fully turned off until a future date in 2024, but if you're using this API, please migrate to the HubDB v3 API, which includes many performance, usability, and API consistency improvements over the previous two versions. Learn more about this sunset on the HubSpot Developer Changelog.

Get the details for a specific HubDB table.  This will include the definitions for the columns in the table, as well as the number of rows in the table.

You can get the draft version of the table by including /draft at the end of the request path. See the example for details. Note: You must include authentication when requesting the draft version.

Required Parameters How to use Description
Hub/Portal ID portalId={Hub ID}
Used in the request URL
The Hub ID that the table belongs to.
Table ID {tableId}
Used in the request URL
The ID of the table that you're looking for.
Optional Parameters How to use Description
Get Draft details /draft
Used in the request URL
Include /draft at the end of the request path to get the draft details of the table.

Example URL: https://api.hubapi.com/hubdb/api/v2/tables/300081?portalId=62515