# How do I use the REST API to create and update records?

> Create an API key in Settings under API Keys, then send JSON to the records endpoints. The API Playground in the builder builds and runs real requests for you.

Source: https://tadabase.com/docs/faq/do-you-have-an-api  
Status: Verified Nov 22, 2026. Checked against the current product

Create an API key in the builder under **Settings** > **API Keys** (the item is greyed out if your plan has no API), then send JSON to the records endpoint at `https://api.tadabase.io/api/v1/data-tables/{tableId}/records`. The **API Playground** on the same page builds and runs real requests against your tables, so you can try a call before you write code.

## Create and update a record

1. **Create a key** In **Settings** > **API Keys**, click **Generate New Key**, turn on **Allow Updates** (and **Allow Reads** to read records back), and click **Save**. A new key starts with every permission off.
2. **Send the three headers** Every call sends `X-Tadabase-App-id`, `X-Tadabase-App-Key` and `X-Tadabase-App-Secret`. Click **Reveal live key** on the key to see the secret.
3. **Create a record** `POST` to `/data-tables/{tableId}/records` with field slugs as keys, for example `{"field_36": "Ada Lovelace"}`. The answer has the new record's ID in `recordId`; add `?return=true` to get the whole saved record back.
4. **Update a record** `POST` (not `PUT`) to `/data-tables/{tableId}/records/{recordId}`. Only the fields you send change.

To upload a file, send the request as `multipart/form-data` with the file under the field slug, or send a public URL and add `<slug>_format` set to `url` so Tadabase downloads it. A JSON field takes JSON as it is. See [Field value formats in the API](https://tadabase.com/docs/developers/field-types-reference) for every field type, and [Create, read, update and delete records](https://tadabase.com/docs/developers/working-with-records) for the full reference.
