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.
- Verified Nov 22, 2026
- Classic builder
- Tadabase AI
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 #
- 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.
- Send the three headers Every call sends
X-Tadabase-App-id,X-Tadabase-App-KeyandX-Tadabase-App-Secret. Click Reveal live key on the key to see the secret. - Create a record
POSTto/data-tables/{tableId}/recordswith field slugs as keys, for example{"field_36": "Ada Lovelace"}. The answer has the new record's ID inrecordId; add?return=trueto get the whole saved record back. - Update a record
POST(notPUT) 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 for every field type, and Create, read, update and delete records for the full reference.
Was this page helpful?
Something wrong or missing on this page? Tell us.