Documentation

Airtable

Connect Airtable with a scoped personal access token so apps and coworkers can read and change records.

The Airtable connector uses a personal access token to access selected bases. Coworkers can read Airtable data, while apps can also create, update, and delete records. Connectors require a paid plan.

Create the token

Workspace owners and admins can connect Airtable.

  1. Create a token in Airtable

    Go to Airtable’s token page. Appaca links to it from the Airtable connector.

  2. Grant three scopes

    Add data.records:read, data.records:write, and schema.bases:read.

  3. Grant access to specific bases only

    Add only the bases Appaca needs.

  4. Paste the token into Appaca

    Go to Settings → Connectors → Airtable. Enter the token in Personal access token, set Access, and select Connect.

  5. Assign the connector

    Open the app or coworker’s Settings → Connectors, enable Airtable, and select Save.

What apps and coworkers can do

  • Coworkers can list bases and tables, preview a table, and search records.
  • Apps can also create, update, and delete records.

Limits worth designing around

Reads return a limited number of records at a time. Record changes may be processed in batches. Deleted records are not moved to a trash folder, and the connector does not upload attachments.

Rotating the token

Open Settings → Connectors → Airtable and enter the new token in Replace personal access token, then select Save.

Connectors overview Understand how connectors work in general. Data overview Compare Airtable with Appaca's own tables. App configurations Where other credentials belong.