Add a row in the table

POST

https://api.clay.com/v3/tables/{TABLE_ID}/records

Adds a new row to the specified table. This endpoint creates a new record in the table with a custom row ID that you provide.

Important: You must provide a unique string identifier for the row ID - this can be any string value of your choice (e.g., "row_123", "custom_id_abc", or any random string). The cells object can be empty {} to create a blank row, or populated with initial column data.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.clay.com/v3/tables/<TABLE_ID>/records' \
--header 'Cookie: {YOUR_CLAY_COOKIES}' \
--header 'content-type: application/json' \
--data '{"records":[{"id":"{RANDOM_STRING}","cells":{}}]}'

Response Example

{}

Modified at 2026-01-16 07:49:46

Fetch all record ids in a table

Delete a row from the table