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.

Update a table

Last updated May 31, 2023

PUT /hubdb/api/v2/tables/:tableId

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?






Required Scope:


There is a new version of this API available.

Update an existing HubDB table. You can use this endpoint to add or remove a column, or to publish a table that's ready to be used.

Table updates will modify the draft table. Use the /publish  endpoint to push all changes live.

Required Parameters How to use Description
OAuth access token or private app access token Authorization: Bearer {token} header Used to authenticate the request. Please see this page for more details about authentication.

Optional Parameters How to use Description
Update Draft details /draft
Used in the request URL
Include /draft at the end of the request path to update the draft version of the table.
Name "name": {new name}
Used in the request
Renames the table
Use for pages "useForPages": {true or false}
Used in the request
Set this to true to enable the table for dynamic pages.
Published at "publishedAt":{millisecond timestamp
Used in the request
Set this to the current (or a past) time to publish a table that's ready to be used
Columns "columns": [ {column list} ]
Used in the request
Updates the columns in the table. See creating a table for the column definitions.
IMPORTANT: Data in this field overwrites the existing columns. If you want to add a new column, you'll need to include the existing columns and the new column in the request.