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 May 15, 2023

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

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Required Scope:


There is a new version of this API available.

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: