Connecting Your Airtable Account

Airtable is the destination for all your synced data. You must connect it before creating any syncs. This guide walks you through the complete OAuth setup process.

Before You Begin

• Make sure you have an Airtable account (free tier works fine)
• Know which Airtable bases you want to sync data into
• Have your Airtable login credentials ready

[Screenshot: Airtable bases list showing example bases]

Step-by-Step Connection Guide

Step 1: Navigate to Your Dashboard

1. Log in to TableSync
2. You'll be taken to your Dashboard automatically
3. Look for the Destination section near the top of the page

[Screenshot: Dashboard header with Destination section highlighted]

Step 2: Initiate the Connection

1. Find the Airtable card in the Destination section
2. Click the blue Connect button
3. A new window will open for Airtable authorization

[Screenshot: Airtable card showing Connect button]

Tip: If the window doesn't open, check if your browser is blocking pop-ups.

Step 3: Log In to Airtable

1. If you're not already logged in, enter your Airtable email and password
2. If you use Google or SSO to sign in to Airtable, use those options instead
3. Complete any two-factor authentication if enabled

[Screenshot: Airtable login page]

Step 4: Select Base Access

This is an important step - choose carefully:

1. You'll see a list of all your Airtable bases
2. Option A: Select All current and future bases for the easiest setup
3. Option B: Select specific bases if you want to limit TableSync's access
4. Check the boxes next to the bases you want to use

[Screenshot: Airtable OAuth screen showing base selection with checkboxes]

Recommendation: If you're just getting started, select all bases. You can always revoke access later from Airtable's settings.

Step 5: Grant Permissions

1. Review the permissions TableSync is requesting:

• Read and write records - Required to add and update synced data
• Read base schema - Required to show you available tables and fields

1. Click the Grant access button
2. Wait for the page to redirect back to TableSync

[Screenshot: Airtable permissions confirmation screen]

Step 6: Verify the Connection

1. You'll be returned to your TableSync Dashboard
2. The Airtable card should now show Connected with a green checkmark
3. Your Airtable email or workspace name will appear below

[Screenshot: Connected Airtable card showing status and account name]

Understanding Permissions

Important: TableSync cannot delete records, manage users, or access billing information in your Airtable account.

Managing Your Connection

Updating Base Access

If you create new bases and want TableSync to access them:

1. Go to your Dashboard
2. Click Reconnect on the Airtable card
3. Select the additional bases
4. Grant access again

Disconnecting Airtable

To remove the connection entirely:

1. Go to your Dashboard
2. Click the three-dot menu on the Airtable card
3. Select Disconnect
4. Confirm the disconnection

Warning: Disconnecting will pause all your active syncs.

Revoking Access from Airtable

You can also remove TableSync's access directly from Airtable:

1. Log in to Airtable
2. Go to your Account settings
3. Find Connected apps or Integrations
4. Locate TableSync and click Revoke access

Troubleshooting

"Pop-up was blocked"

Solution:

1. Click the blocked pop-up icon in your browser's address bar
2. Allow pop-ups from tablesync.io
3. Try connecting again

[Screenshot: Browser showing pop-up blocked indicator]

"Authorization failed"

Possible causes and solutions:

• Wrong account: Make sure you're logging into the correct Airtable account
• Session expired: Log out of Airtable completely, then try connecting again
• Browser issue: Try using a different browser or incognito/private mode

"I don't see my bases"

Solutions:

• Check if the bases are in a workspace you have access to
• Verify you selected those bases during the authorization step
• Try reconnecting and selecting the missing bases

"Connection shows as disconnected"

This can happen if:

• You revoked access from Airtable
• Your Airtable password changed
• The connection token expired (rare)

Solution: Click Reconnect and go through the authorization again.

Frequently Asked Questions

Can I connect multiple Airtable accounts?

Currently, TableSync supports one Airtable connection per account. If you need to sync to multiple Airtable workspaces, contact support.

Will TableSync work with Airtable's free plan?

Yes! TableSync works with all Airtable plans, including the free tier.

How long does the connection last?

The connection remains active indefinitely unless you revoke it from Airtable or your credentials change.

Can TableSync see my other Airtable data?

TableSync can only access the bases you specifically granted permission to during setup. We cannot see bases you didn't select.

What if I need to change my Airtable password?

After changing your password, you'll need to reconnect TableSync. Your existing sync configurations will remain intact.