There's a new version of the HubSpot API

Check out the new 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:

GET

Response Format:

json

Requires Authentication?

No

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing & CRM

Required Scope:

hubdb

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: https://api.hubapi.com/hubdb/api/v2/tables/300081?portalId=62515

About

Jobs

Learn Inbound

Support

Locations

HubSpot, Inc.
25 First Street, 2nd Floor
Cambridge, MA 02141
European Headquarters
Ground Floor, Two Dockland Central
Guild Street, Dublin 1
Asia/Pacific Office
20 Hunter St, Level 7
Sydney NSW 2000
View our other locations
Example GET URL: https://api.hubapi.com/hubdb/api/v2/tables/300081?portalId=62515 Example GET URL for the draft details: https://api.hubapi.com/hubdb/api/v2/tables/300081/draft Example Response: { "id": 300081, "name": "Example Table 1", "createdAt": 1479479977286, "publishedAt": 1479480005606, "updatedAt": 1479480005781, "columns": [ { "name": "Name", "label": null, "id": 1, "type": "TEXT" }, { "name": "datecol", "label": "datecol", "id": 2, "type": "DATE" } ], "deleted": false, "useForPages": false, "rowCount": 0, "createdBy": null, "updatedBy": null, "columnCount": 2 }