Create field

Add a field, a column, to a table. Its type decides what its cells accept and how they filter and sort; Working with Tables lists every type.

POST/v1/w/{workspace}/tables/{tableId}/fields

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

Path parameters

workspacestringrequired

Your workspace’s address name.

tableIdstringrequired

The table to add it to.

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 field’s name, like “Status”.

typeenumrequired

The field type, like text, number, currency, date or single_select. It can’t change later.

optionsobject

Settings for the type, such as choices for a select or precision for a number.

Response

fieldobjectrequired

Details

Create any supported field, including Formula and Olamma link (ref). Ref options: types (task, page, customer, conversation), multiple. Olamma links accept at most 50 visible refs per cell.

Since 2026-12. Errors are listed in Errors.

cURL

curl -X POST "https://api.olamma.sh/v1/w/your-workspace/tables/{tableId}/fields" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  -H "Idempotency-Key: <unique key>" \
  -H "content-type: application/json" \
  -d '{
    "name": "Status",
    "type": "single_select",
    "options": {
      "choices": [
        {
          "id": "paid",
          "name": "Paid",
          "color": "green"
        },
        {
          "id": "pending",
          "name": "Pending",
          "color": "amber"
        }
      ]
    }
  }'

Response 201

{
  "field": {
    "id": "<string>",
    "tableId": "<string>",
    "name": "<string>",
    "type": "<string>",
    "options": {},
    "position": 123
  }
}