---
title: "Create a row"
method: POST
path: "/tables/{tableId}/rows"
tags: ["rows"]
---

# Create a row

`POST /tables/{tableId}/rows`

Creates a row within the specified table.

## Path parameters

- `tableId` string, required

## Headers

- `x-budibase-app-id` string, required

## Request body

- Row — The row to be created/updated, based on the table schema.

## Response `200`

Returns the created row, including the ID which has been generated for it. This can be found in the Budibase portal, viewed under the developer information.

- RowOutput
  - `data` object, required — The row to be created/updated, based on the table schema.
    - `_id` string, required — The ID of the row.
    - `tableId` string, required — The ID of the table this row comes from.

---

[API](https://skmtc.net/budibase/apis/budibase-api.md) · [All operations](https://skmtc.net/budibase/apis/budibase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/budibase/budibase-api/revisions/9c6f16fc652b/schema)