Skip to main content
POST
Add a new empty row to a list.

Authorizations

X-API-Key
string
header
required

Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.

Path Parameters

listId
string
required

Body

application/json

Optional body. Only companyId is consumed; row data should be sent via PUT /lists//row after creation, or use POST /lists//rows to add rows with data in one call.

Optional request body for creating a single empty row. All fields are optional.

companyId
string

Company ID that owns the list. Required when authenticating with a personal access key (pak_…) — the key is not tied to a specific company so the server cannot infer it. Required when authenticating with a company API key only if the key belongs to a user who has access to multiple companies; otherwise it defaults to the key's company. Optional for JWT (dashboard) auth — defaults to the user's active company.

Response

Newly-created (empty) row

Response returned after adding a single empty row

row
object

The newly-created (empty) row