HUhubspot
Tables

Import data into draft table

Changed on

Import the contents of a CSV file into an existing HubDB table. The data will always be imported into the draft version of the table. Use the /publish endpoint to push these changes to the published version. This endpoint takes a multi-part POST request. The first part will be a set of JSON-formatted options for the import and you can specify this with the name as config. The second part will be the CSV file you want to import and you can specify this with the name as file. Refer the overview section to check the details and format of the JSON-formatted options for the import.

post/cms/hubdb/2026-03/tables/{tableIdOrName}/draft/import

Request

Path parameters

tableIdOrNamestring required

Request body multipart/form-data

configstring
filestring binary

Response

successful operation

duplicateRowsinteger required

Specifies number of duplicate rows

rowLimitExceededboolean required

Specifies whether row limit exceeded during import

rowsImportedinteger required

Specifies number of rows imported

Example response

{
  "errors": [
    {
      "category": "VALIDATION_ERROR",
      "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
      "links": {
        "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
      },
      "message": "Invalid input (details will vary based on the error)"
    }
  ]
}

Changes

  • b0d8bc008db9Revision changes
    • info

      api operation id post-/cms/hubdb/2026-03/tables/{tableIdOrName}/draft/import_importDraftTable removed and replaced with post-/cms/hubdb/2026-03/tables/{tableIdOrName}/draft/import

  • dc2fdad57f7fRevision changes
    • info

      endpoint added

Some revisions have not been checked yet.