> For the complete documentation index, see [llms.txt](https://docs.appmixer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appmixer.com/connector-configuration/airtable.md).

# Airtable

## OAuth app properties

| Property                | Value                                                                                                                                                                                                   |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Multi-tenant**        | **Yes.** Users of any Airtable account can authorize one integration. On Enterprise plans, an admin can block third-party integrations for the organization unless the integration is on the allowlist. |
| **Vendor review**       | **None.** Before you share the integration with other users, it needs a **Privacy policy URL** and a **Terms of service URL**.                                                                          |
| **Review time**         | Not applicable.                                                                                                                                                                                         |
| **Users before review** | No limit.                                                                                                                                                                                               |
| **App owner**           | Any Airtable account.                                                                                                                                                                                   |
| **Regions**             | One integration works worldwide.                                                                                                                                                                        |
| **Client secret**       | No expiry documented. It is shown only once; it can be regenerated or deleted at any time, which breaks token requests made with the old one.                                                           |
| **Rate limits**         | No per-integration limit published. 5 requests per second per base, shared by everything that calls that base.                                                                                          |
| **Checked**             | 2026-11-13                                                                                                                                                                                              |

**Limitations**

* A connected account stops working when its refresh token is not used for 60 days. The user then connects the account again.
* A refresh token is single use. Each refresh invalidates the previous access and refresh token; reusing an old one revokes the authorization.
* One Airtable user can authorize the same integration at most 20 times. After that, an older authorization has to be revoked first.
* The integration must have all scopes the connector requests enabled: `user.email:read`, `schema.bases:read`, `data.records:read`, `data.records:write`. The token only reaches the bases the user picks on the consent screen.

Sources: [OAuth integrations](https://airtable.com/developers/web/guides/oauth-integrations), [OAuth reference](https://airtable.com/developers/web/api/oauth-reference), [Rate limits](https://airtable.com/developers/web/api/rate-limits), [Third-party integrations via OAuth](https://support.airtable.com/articles/6811769763-third-party-integrations-via-oauth-overview), [Admin panel settings](https://support.airtable.com/articles/9656884884-settings-airtable-admin-panel). What the rows mean: [OAuth app properties](https://docs.appmixer.com/connector-configuration/oauth-app-properties.md).

### **Setup the App and Administrator account**

Sign up with Airtable: <https://airtable.com/signup>

#### **Specify Base name**

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-c144b43e1a9979edeea600265cd57c51b7b74cad%2Fairtable-1.png?alt=media" alt="Specify base name" width="305"><figcaption><p>Specify base name</p></figcaption></figure>

**Specify Table name**

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-7e3174853ff7d854b1066d75e516d43ab0fdf5d1%2Fairtable-2.png?alt=media" alt="" width="317"><figcaption><p>Specify table name</p></figcaption></figure>

#### **Specify Table details (fields)**

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-abfa47d2a8f61df73ac952bbfe022fac62c42af0%2Fairtable-3.png?alt=media" alt="" width="280"><figcaption><p>Specify table details</p></figcaption></figure>

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-0f354e973e56041b2f5562e74600834b91143467%2Fairtable-4.png?alt=media" alt="" width="375"><figcaption><p>Airtable workspace created</p></figcaption></figure>

Now the Airtable workspace/base is prepared. Let's configure the OAuth app.

### **2. Register OAuth app**

#### Specify name

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-f163904ce023c9d939b66443f6da41e2e314a943%2Fairtable-5.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Specify name and callback url

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-2d37559ef4d8156b8e18fa57c1aab5f8b8b8eda6%2Fairtable-6.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Generate client secret

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-914f0a575ed0559cf498cd67639e4a6b62f52b42%2Fairtable-7.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Specify scopes

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-a0b1b2bf788e93238214e6b58c85bfd4ca28eb62%2Fairtable-8.png?alt=media" alt=""><figcaption></figcaption></figure>

## Backoffice configuration

Configuration ID: `appmixer:airtable` (Backoffice → Configuration; see [Connector Configuration](https://docs.appmixer.com/getting-started/services) for how a configuration is created and how its keys reach the connector).

* `clientId` — Client ID of the Airtable OAuth integration registered above. Not needed when Airtable is authenticated through the Appmixer Auth Hub.
* `clientSecret` — Client secret of the same integration. Not needed with the Auth Hub.
* `listBasesCacheTTL` — Optional. How long, in milliseconds, the list of bases shown in the **Base** dropdown is cached. Default `20000` (20 seconds).
* `listTablesCacheTTL` — Optional. How long, in milliseconds, the list of tables shown in the **Table** dropdown is cached. Default `20000` (20 seconds).
* `outputFilePrefix` — Optional. File name prefix of the CSV file that **List Bases**, **List Tables** and **List Records** create when their output is set to *File*; the file is named `<prefix>-<component name>.csv`. Default `airtable-export`.

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-f9f4f0d5dd504b5cee0e934f781b95a946e5135c%2Fairtable-9.png?alt=media" alt=""><figcaption><p>Backoffice Airtable connector configuration</p></figcaption></figure>

The same keys can be set with the CLI (`-u` updates the existing configuration instead of creating it):

```bash
appmixer service-config set appmixer:airtable -u -d '{
  "clientId": "<client id>",
  "clientSecret": "<client secret>"
}'
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.appmixer.com/connector-configuration/airtable.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
