v14

latestOpenAPI 3.0.0raw.githubusercontent.com2026-05-279719892.3 MB

Tables

Import data into draft table

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

Path parameters

tableIdOrNamestring required

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)"
    }
  ]
}