---
title: "Airtable API: connect it to a tool built with AI (2026)"
url: https://while.sh/en/guides/connect-airtable-api-ai-tool/
author: "Aloïs Oddon, co-founder of Nextmap"
updated: 2026-11-18
---

# Connect Airtable to a tool built with Claude or ChatGPT (2026)

Your team lives in Airtable, and your tool built with Claude needs to read or update its tables. The Airtable token acts as your own account, and it must end up neither in the code nor in the conversation. On while, it stays in while, and your AI never sees it. Here is how.

Many teams live in **Airtable**: project tracking, inventory, applications, orders. A tool built with Claude or ChatGPT takes over when you need **more than a table**: a screen for technicians, a dashboard for management, a form for a client. To read or update your tables, it needs an **Airtable token**, and that token acts **as your own account**.

That is where things often go wrong: **the token ends up pasted into the code**, or into the conversation with the AI, where it can leak. On while, the Airtable token **stays in while**. The tool calls Airtable without ever holding it, and your AI never sees it.

> **The short version.** Create a personal access token in Airtable, with only the scopes and bases the tool needs. Ask your AI to connect Airtable, then paste the token into while through the link it gives you. The tool reads and updates your tables, every call is logged, and a write waits for the rule you approve.

## What the Airtable token can do

A personal access token acts as your account, **within the limits you give it**: scopes, and bases (sources 1 and 3).

| Setting | What it allows | Our advice |
|---|---|---|
| data.records:read | Reading records | Always, if the tool reads |
| data.records:write | Creating, editing, deleting records | Only if the tool writes |
| schema.bases:read | Reading the structure of tables and fields | Useful for your AI to build the tool |
| The bases added | The bases and workspaces the token can touch | Only the tool's own |

A token with read access only and a single base **cannot do anything else**, even if it leaks.

## Connect Airtable to your tool, in three steps

The whole thing takes a few minutes, and you have no code to write.

1. **Create a token in Airtable.** At **airtable.com/create/tokens**, click **Create new token**. Choose the scopes, then click "add a base" to add only the tool's bases. Create the token and copy it: Airtable shows it **only once** (source 1).
2. **Ask your AI to connect Airtable.** It declares the connection in while and gives you a link.
3. **Paste the token into while.** You open the link, paste the token and confirm. Neither your AI nor the tool's code sees it.

> You, to your AI: Connect Airtable to this tool, to our "Field jobs" base, and build a screen for technicians: today's jobs, and a button to mark them done.

<figure class="illus"><img src="/illustrations/airtable-relais-1200.webp" srcset="/illustrations/airtable-relais-768.webp 768w, /illustrations/airtable-relais-1200.webp 1200w" sizes="(min-width: 48rem) 46rem, 100vw" width="1536" height="1024" loading="lazy" decoding="async" alt="The tool built with AI calls the Airtable API through while: the personal access token is added to each call inside while, out of the code, every read of the tables is logged and a record change waits for the rule a person approves" /><figcaption>The tool calls Airtable through while, which adds the token to each call.</figcaption></figure>

## What while does on each call

The tool calls Airtable **through while**, without a token. while adds the token to each call, and logs it in the history. For the first seven days, reads go through and teach while what the tool calls. **A write**, like editing or deleting a record, goes through once you approve its rule. After that, an unexpected call is refused, and your AI is told.

You can also ask for your approval before a sensitive call.

> You, to your AI: Ask me before every record deletion in Airtable.

Airtable accepts **5 requests per second per base**. Beyond that, it answers with a 429 error and asks you to wait 30 seconds (source 2). A team screen stays well below that, and your AI takes it into account when it builds the tool.

The credentials of your software are detailed on our [security](/en/security/) page, and the same mechanism works for any API in [connect an API with no credentials in the code](/en/guides/api-keys-out-of-code/).

## Changing the token

From the tokens page, you can edit a token's scopes and bases, regenerate it or delete it. A regenerated token keeps its name and scopes, and the old one is **rejected at once** (source 1). **Paste the new one into while**: the tool uses it from the next call, without being put back in place.

## What while adds around it

- **Your colleagues** use the tool with a while account for up to 3 people, or, on the Pro plan, with their email account, Google or Microsoft, with no extra Airtable seat. See [keep a tool for your colleagues](/en/guides/internal-tool-company-sign-in/).
- **A client** uses the tool with [an access link and a password](/en/guides/share-app-with-password/), valid for 1, 7 or 30 days.
- **The tool's data** is backed up every day, and your tools are hosted in France by Nextmap.

To go further, see [connect Google Sheets](/en/guides/connect-google-sheets-ai-tool/), [connect Notion](/en/guides/connect-notion-ai-tool/) and [replace a shared Excel file with a tool built with AI](/en/guides/replace-shared-excel-file-ai-tool/).

## Try it with your tool

Give this message to your AI, then ask it to connect Airtable. The trial is **free, with no sign-up**, and your tool has its address **in 3 minutes**.

```text titre="The message to give your AI"
Read while.sh/agents and help me get started with while.
```

## Sources

1. [Airtable, Personal access tokens](https://airtable.com/developers/web/guides/personal-access-tokens), 2026-11-18
2. [Airtable, Rate limits](https://airtable.com/developers/web/api/rate-limits), 2026-11-18
3. [Airtable, Scopes](https://airtable.com/developers/web/api/scopes), 2026-11-18

## Questions

### How do you get an Airtable API token?

At airtable.com/create/tokens, click Create new token, choose the scopes, add the bases the token can access, then create it. Airtable shows it only once (source 1).

### Which scopes should you give the Airtable token?

Only the ones the tool needs: data.records:read to read records, data.records:write if it must write, and schema.bases:read if it must read the table structure. Add only the bases the tool needs (sources 1 and 3).

### Does my AI see the Airtable token?

No. Your AI declares the connection to Airtable and gives you a link. You paste the token into while there, and neither your AI nor the tool's code sees it.

### How many calls does the Airtable API accept?

5 requests per second per base, and 50 per second for all of one person's tokens. Beyond that, Airtable answers with a 429 error and asks you to wait 30 seconds (source 2).

### What happens when I regenerate the token?

The old one is rejected at once, and the new one keeps the same name and scopes. Paste the new one into while: the tool uses it from the next call (source 1).
