> ## Documentation Index
> Fetch the complete documentation index at: https://filla.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting Airtable

> How to connect your Airtable account to Filla and manage access.

## How Filla and Airtable work together

Filla doesn't store your form submissions — they go straight to your Airtable base. Connecting Airtable is how Filla knows where to write your data, not how it accesses it. Most form tools (Typeform, Jotform, Fillout) host submissions on their own servers and sync to Airtable downstream. Filla works the other way around: your Airtable base is the database.

That's why connecting at least one base is required before you can build anything.

## Connecting your account

Filla connects to Airtable via OAuth 2.0. You authorize Filla without ever sharing your Airtable password.

<Steps>
  <Step title="Click Connect my base">
    From the empty Forms / Tools / Documents page or from workspace **Settings → Connect Airtable**.
  </Step>

  <Step title="Read the consent primer">
    A short dialog explains what you'll see on Airtable's screen and which option to pick. There are two paths on Airtable's consent page:

    * **Add all resources** *(recommended)* — gives Filla access to every base across every workspace, including any you add later. Set it once and you won't come back to adjust.
    * **Add a base** — pick specific bases now. Adding a new base later means reconnecting.

    Pick "Add all resources" unless you have strict access requirements.
  </Step>

  <Step title="Continue to Airtable">
    Click **Connect my base** to open Airtable's authorization page. Sign in if prompted, pick the scope, then click **Grant access**.
  </Step>

  <Step title="You're back in Filla">
    Airtable redirects you back. The empty state disappears and you're ready to build.
  </Step>
</Steps>

<Warning>
  Make sure the workspace or base you authorize contains at least one base with tables. If Filla returns from OAuth to an empty scope, your forms have nowhere to send submissions to. The Forms page will show a "no bases came through" hero with a button to re-open Airtable's consent screen and include a base.
</Warning>

## What Filla accesses

| Permission          | What it does                                                                       |
| ------------------- | ---------------------------------------------------------------------------------- |
| Read base schema    | Sees your tables, fields, and views so you can configure forms and tools           |
| Read records        | Fetches records for linked record pickers, processor tools, and edit-mode forms    |
| Write records       | Creates new records from form submissions and updates records from processor tools |
| Read/write comments | Powers the comments feed on form submissions                                       |

## Revoking access

You can disconnect Filla at any time:

1. Go to [airtable.com/account](https://airtable.com/account)
2. Scroll to **Integrations**
3. Find Filla and click **Revoke**

<Warning>
  Revoking access will immediately stop all forms and processor tools from working. Reconnect Airtable in your workspace settings to restore them.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="I see 'Token expired' errors">
    Filla automatically refreshes your Airtable token. If you see this error, go to workspace settings and click **Reconnect Airtable** to re-authorize.
  </Accordion>

  <Accordion title="My new base doesn't appear">
    Filla can only access bases you authorized during the OAuth flow. If you originally picked "Add a base" instead of "Add all resources," any base you create later won't be visible until you reconnect. Click **Reconnect** in workspace settings (or use the **Choose a base** button on the no-bases empty state) and include the new base — or re-authorize with "Add all resources" so future bases appear automatically.
  </Accordion>

  <Accordion title="I authorized a workspace but no bases appeared">
    The Airtable workspace you picked doesn't contain any bases. Filla needs at least one base to route submissions to. Open Airtable again from the no-bases empty state on the Forms page, and pick a workspace or specific base that has tables in it.
  </Accordion>

  <Accordion title="Fields are missing from my form">
    Filla syncs your base schema when you open the editor and when you return to the tab after being away. Click the **Sync fields** button in the editor toolbar to manually pull the latest fields from Airtable.
  </Accordion>
</AccordionGroup>