There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.

Get details for a specific table

Last updated June 17, 2020

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

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Required Scope:


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: