---
title: "Create rows in batch"
method: POST
path: "/cms/hubdb/2026-03/tables/{tableIdOrName}/rows/draft/batch/create"
tags: ["Rows"]
---

# Create rows in batch

`POST /cms/hubdb/2026-03/tables/{tableIdOrName}/rows/draft/batch/create`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/cms/hubdb/2026-03/tables/{tableIdOrName}/rows/draft/batch/create`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `hubdb`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `hubdb.rows.write`

Creates rows in the draft version of the specified table, given an array of row objects. Maximum of 100 row object per call. See the overview section for more details with an example.

## Path parameters

- `tableIdOrName` string, required

## Request body

- BatchInputHubDbTableRowV3Request
  - `inputs` HubDbTableRowV3Request[], required: An array of HubDbTableRowV3Request objects, each representing a row to be created. This property is required.
    - `childTableId` integer, required: Specifies the value for the column child table id
    - `displayIndex` integer, required: The index position for displaying the row within the table.
    - `name` string: Specifies the value for `hs_name` column, which will be used as title in the dynamic pages
    - `path` string: Specifies the value for `hs_path` column, which will be used as slug in the dynamic pages
    - `values` object, required: List of key value pairs with the column name and column value

## Response `201`

successful operation

- BatchResponseHubDbTableRowV3
  - `completedAt` string, date-time, required: The timestamp indicating when the batch processing was completed.
  - `links` object: A collection of related links associated with the batch response.
  - `requestedAt` string, date-time: The timestamp indicating when the batch request was made.
  - `results` HubDbTableRowV3[], required: An array of HubDbTableRowV3 objects representing the results of the batch operation.
    - `childTableId` string, required: Specifies the value for the column child table id
    - `createdAt` string, date-time, required: Timestamp at which the row is created
    - `id` string, required: The id of the table row
    - `name` string, required: Specifies the value for `hs_name` column, which will be used as title in the dynamic pages
    - `path` string, required: Specifies the value for `hs_path` column, which will be used as slug in the dynamic pages
    - `publishedAt` string, date-time, required: The timestamp indicating when the row was last published, in date-time format.
    - `updatedAt` string, date-time, required: Timestamp at which the row is updated last time
    - `values` object, required: List of key value pairs with the column name and column value
  - `startedAt` string, date-time, required: The timestamp indicating when the batch processing began.
  - `status` 'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING', required: The current status of the batch operation, with possible values: CANCELED, COMPLETE, PENDING, PROCESSING.

## Other responses

- `207`: multiple statuses
- `default`: An error occurred.

## Changes

- **2026-11-02** (2026-03) `57dfaa14c811`: 2 info
  - the security scope `hubdb` was added to the endpoint's security scheme `oauth2`
  - the security scope `hubdb.rows.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-10** (2026-03) `f907bc4f599c`: 2 info
  - the security scope `hubdb.rows.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `hubdb-data-write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-09** (2026-03) `aae1075c6909`: 2 info
  - the security scope `hubdb-data-append` was added to the endpoint's security scheme `oauth2`
  - the security scope `hubdb.rows.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-07** (2026-03) `531201597da3`: 2 info
  - the security scope `hubdb` was added to the endpoint's security scheme `oauth2`
  - the security scope `hubdb.rows.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-04** (2026-03) `6b6a597c6598`: 2 info
  - the security scope `hubdb` was added to the endpoint's security scheme `oauth2`
  - the security scope `hubdb.rows.write` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/cms-hubdb/changes/cms/hubdb/2026-03/tables/:tableIdOrName/rows/draft/batch/create/post.md)

---

[API](https://skmtc.dev/hubspot/apis/cms-hubdb.md) - [All operations](https://skmtc.dev/hubspot/apis/cms-hubdb/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/cms-hubdb/revisions/57dfaa14c811?raw)