---
title: "Create row in a custom table (by table name)"
method: POST
path: "/v1/custom-table-data/{tableName}"
tags: ["Custom Tables: Content"]
---

# Create row in a custom table (by table name)

`POST /v1/custom-table-data/{tableName}`

## Request

- Base URL: `https://api.finalpos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.finalpos.com/v1/custom-table-data/{tableName}`
- Auth: API key in header `x-api-key`

Creates a new row (and its cell values) under the table resolved from the path `tableName`.

## Path parameters

- `tableName` string, required

## Request body

- CreateCustomTableDataDto

## Response `201`

Assembled row payload after create (`CustomTableDataResponseDto`).

- CustomTableDataResponseDto
  - `rowId` object, required: Row ID

## Other responses

- `400`: Validation failure, unknown fields, or other request errors.
- `404`: `tableName` does not resolve to a table for this company.

---

[API](https://skmtc.dev/finalpos/apis/final-pos-public-api.md) · [All operations](https://skmtc.dev/finalpos/apis/final-pos-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finalpos/apis/final-pos-public-api/revisions/6a6842dcb479?raw)