Skip to main content
POST
/
cms
/
v3
/
hubdb
/
tables
/
{tableIdOrName}
/
draft
/
import
Import data into draft table
curl --request POST \
  --url https://api.hubapi.com/cms/v3/hubdb/tables/{tableIdOrName}/draft/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'config=<string>' \
  --form file='@example-file'
{
  "duplicateRows": 123,
  "errors": [
    {
      "message": "Invalid input (details will vary based on the error)",
      "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
      "category": "VALIDATION_ERROR",
      "links": {
        "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
      }
    }
  ],
  "rowLimitExceeded": true,
  "rowsImported": 123
}

Supported products

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

tableIdOrName
string
required

The ID or name of the HubDB table.

Body

multipart/form-data
config
string
file
file

Response

successful operation

duplicateRows
integer<int32>
required

Specifies number of duplicate rows

errors
object[]
required

List of errors during import

rowLimitExceeded
boolean
required

Specifies whether row limit exceeded during import

rowsImported
integer<int32>
required

Specifies number of rows imported

Last modified on February 12, 2026