Connect Air Fill to Airtable

Before you can build or fill a form, Air Fill needs permission to reach your Airtable data. There are two ways to connect. We recommend signing in with Airtable; a personal access token is there as a fallback if you need it.

Option 1: Sign in with Airtable (recommended)

This opens Airtable’s own sign-in page, so you never hand your password to Air Fill. It requires iOS 17.4 or later.

1. In Air Fill, tap Sign in with Airtable.
2. Airtable’s sign-in page opens. Log in there if you aren’t already.
3. Review the permissions Air Fill asks for, then approve.
4. You’ll return to Air Fill, connected and ready.

Air Fill requests four permissions so it can do its job:

• Read records (data.records:read) — to show your existing data.
• Write records (data.records:write) — to save form submissions and updates.
• Read base schema (schema.bases:read) — to see your tables and fields so it can build the form.
• Read your account email (user.email:read) — so Air Fill can show which account is connected.

Option 2: Personal access token

If signing in with Airtable isn’t available to you, you can create a personal access token in your Airtable account and paste it into Air Fill. You create the token in Airtable, so those steps live on Airtable’s site and their screens may look a little different over time.

1. Go to the personal access tokens page in your Airtable account: airtable.com/create/tokens.
2. Create a new token.
3. Add these three scopes: schema.bases:read, data.records:read, and data.records:write.
4. Grant the token access to the base or bases you’ll use with Air Fill.
5. Copy the token, return to Air Fill, and paste it in.

A note on write access: Airtable doesn’t tell Air Fill in advance whether a token can write. If a token is missing write access, everything looks fine until you try to submit — then you’ll see a permission error (a 403). The fix is to edit or recreate the token so it has data.records:write and access to that base.

Where your login is stored

Your credentials are kept in your device’s Keychain, encrypted by iOS. They’re shared only with other Air Pack apps on the same device, and they’re never sent to Knock Knock Bang or Air Fill. Air Fill talks directly to Airtable from your device — there’s no Air Fill account and no Air Fill server holding your data.

Troubleshooting

• “Sign in with Airtable” is greyed out. This option needs iOS 17.4 or later. Update iOS, or use a personal access token instead.
• Air Fill can’t see my base. The connection needs schema.bases:read and access to that specific base. If you’re using a token, edit it to include that scope and add the base.
• Submission failed with a permission error. The connection needs data.records:write on that base. Recreate or edit the token with write access and access to the base, then try again.