Create table

Create a table in a base. It starts with a Name field and a Grid view; add your own fields next with Create field.

POST/v1/w/{workspace}/bases/{baseId}/tables

Send an Idempotency-Key. This may answer 202 while it waits for approval.

Path parameters

workspacestringrequired

Your workspace’s address name.

baseIdstringrequired

The base to add it to, from List bases.

Headers

Idempotency-Keystring

8–100 characters. Repeat the same key and body to get the first outcome back instead of writing twice.

Body

namestringrequired

The table’s name, like “Orders”.

Response

tableobjectrequired

fieldsobject[]required

viewsobject[]required

Details

Create a table in an editable base.

Since 2026-12. Errors are listed in Errors.

cURL

curl -X POST "https://api.olamma.sh/v1/w/your-workspace/bases/{baseId}/tables" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  -H "Idempotency-Key: <unique key>" \
  -H "content-type: application/json" \
  -d '{
    "name": "Orders"
  }'

Response 201

{
  "table": {
    "id": "<string>",
    "baseId": "<string>",
    "name": "<string>",
    "rowCount": 123,
    "primaryFieldId": "<string>"
  },
  "fields": [
    {
      "id": "<string>",
      "tableId": "<string>",
      "name": "<string>",
      "type": "<string>",
      "options": {},
      "position": 123
    }
  ],
  "views": [
    {
      "id": "<string>",
      "tableId": "<string>",
      "name": "<string>",
      "type": "<string>",
      "config": {},
      "version": "<string>"
    }
  ]
}