Add a row
Add a row for one of your contacts (a prescription, an order, a booking), or to a reference table.
A records table's row belongs to a contact of your workspace, so contact_id is required; a row never creates one (not_found otherwise; create the contact first with POST /api/v1/contacts).
A reference table's row belongs to no one: send data (and notes) only. A contact_id or a status is refused with validation_failed.
status defaults to the table's first status. data is checked against the columns: a value that does not fit, or a key that is not a column, is refused with validation_failed and details.fields naming each one.
A table holds at most 50,000 rows; past that the call is refused with conflict.
Send an Idempotency-Key header to make a retry safe. The new row fires table_row.created and the automations listening for it.
Request
- Base URL: https://app.blueticked.com
- URL: https://app.blueticked.com/api/v1/tables/{id}/rows
- Auth: HTTP bearer
Path parameters
The resource's unique identifier.
Headers
A unique key (e.g. a UUID) that makes a POST safe to retry: replaying the same key within 24h returns the original result instead of acting twice.
Request body
Example request
{
"contact_id": "ff506e53-e2f0-4d92-884a-dab77d628bad",
"status": "received",
"data": {
"medicine": "Amoxicillin 500mg",
"quantity": 21,
"collect_on": "2026-10-02"
},
"notes": "Repeat script"
}Response
Success
Example response
{
"row": {
"id": "8e2f4a6c-1b3d-4e5f-9a7b-2c4d6e8f0a12",
"table_id": "3c5e7a9b-2d4f-4a6c-8e0b-1d3f5a7c9e24",
"source": "api",
"created_at": "2026-10-01T10:00:00.000Z",
"updated_at": "2026-10-01T10:00:00.000Z"
},
"request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}Changes
No recorded changes to this operation across all 1 revision of this API.