Keys / Airtable

AIRTABLE_API_KEY

The personal access token your app calls the Airtable API with. Airtable retired API keys on February 1, 2024; this variable now holds a token.

Starts with
pat
Expires
never, unless an enterprise admin sets a limit
API
list and revoke, for enterprise admins; no create

Get it

Create one on airtable.com/create/tokens. The steps aren't recorded yet.

Set it

AIRTABLE_API_KEY=pat...

The official JavaScript client, airtable.js, reads it from this variable when you don't pass apiKey. Or keep it out of .env with keypin: keypin run -- npm run dev

Replace it

  1. In the developer hub, open the token's … menu and click Regenerate token. It keeps its name, scopes and bases. The old token stops working at once.
  2. Deploy the new token everywhere that reads AIRTABLE_API_KEY right away.
  3. To avoid the gap, create a new token with the same scopes and bases instead, deploy it, check that nothing still uses the old token, then delete the old one.

Set rotate_every on the key in keypin.toml and a rotated date on its vault item, and keypin status shows when it's due.

Sources, checked 2026-11-16