Menu QaldyDocs

Airtable

Read and write records in your Airtable bases.

Apps read and write records in your Airtable bases with a personal access token. Airtable is reached through the HTTP API connector with a preset: the gate calls only api.airtable.com/v0, with GET, POST and PATCH. The token is sealed to the gate and apps never see it.

Status: Available through the HTTP API preset. The preset follows Airtable's Web API reference (checked 2026-10-16). It has not been run against a live base.

Connect it

  1. In Airtable, open the Builder hub → Personal access tokens (airtable.com/create/tokens) and create a token.
  2. Give it only the scopes the apps need, for example data.records:read and data.records:write, and add only the bases they use. The token's scopes are the real fence: the gate's method list is the second one.
  3. Copy the token. It starts with pat, and Airtable shows it once.
  4. Qaldy → Connectors → Airtable → Connect Airtable → paste the token → Seal and connect.

Test connection calls GET /v0/meta/whoami, which answers for any valid token.

What the gate allows

Hostapi.airtable.com, base path /v0 (pinned, every resolved address public)
MethodsGET, POST, PATCH (no PUT, no DELETE: an app can add and change records, not wipe them)
Pathseverything under /v0
KeyAuthorization: Bearer <token>, added by the gate

Use it from an app

json
{ "id": "http", "actions": ["request"], "scope": "conn_k3v9…" }
ts
const api = ctx.connectors.http('conn_k3v9…')
const list = await api.get('/<base id>/<table name>', { query: { maxRecords: 10 } })
await api.post('/<base id>/<table name>', {
  json: { records: [{ fields: { Name: 'Aigerim', Status: 'New' } }] },
})

When it breaks

You seeWhyDo
401 AUTHENTICATION_REQUIREDThe token was revoked or mistypedReplace the token
403 INVALID_PERMISSIONS_OR_MODEL_NOT_FOUNDThe token lacks the scope or the baseEdit the token's scopes and bases in Airtable
422A field name or type doesn't match the tableCheck the table's fields

Type to search. Up and down to choose, Enter to open, Esc to close.