---
title: "Add a new row to a table"
method: POST
path: "/cms/hubdb/2026-03/tables/{tableIdOrName}/rows"
tags: ["Rows"]
---

# Add a new row to a table

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

Add a new row to a HubDB table. New rows will be added to the draft version of the table. Use the `/publish` endpoint to push these changes to published version.

## Path parameters

- `tableIdOrName` string, required

## Request body

- HubDbTableRowV3Request
  - `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

- HubDbTableRowV3
  - `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

## Other responses

- `default` — An error occurred.

## Changes

- **2026-07-13** (v3) `18fde1f09597` — 1 info
  - endpoint added
- **2024-05-30** (v3) `4f23fa1e0b9f` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/hubspot/apis/cms-hubdb/changes/cms/hubdb/2026-03/tables/:tableIdOrName/rows/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/18fde1f09597?raw)