There's a new version of the HubSpot API

Check out the new API
View Beta Docs

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

Get details for a specific table

Last updated January 7, 2025

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

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 }