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
{
  "rowLimitExceeded": true,
  "duplicateRows": 123,
  "rowsImported": 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"
      }
    }
  ]
}
Supported products
Requires one of the following products or higher.
Marketing HubMarketing HubFree
Sales HubSales HubFree
Service HubService HubFree
Content HubContent HubFree

Required Scopes

This API requires one of the following scopes:
  • hubdb

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 of the destination table where data will be imported.

Body

multipart/form-data
config
string
file
file

Response

successful operation

rowLimitExceeded
boolean
required

Specifies whether row limit exceeded during import

duplicateRows
integer
required

Specifies number of duplicate rows

rowsImported
integer
required

Specifies number of rows imported

errors
object[]
required

List of errors during import