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

# Common errors - Airtable

Common error messages from Airtable and how to resolve them

### 1) "**You have reached the maximum access authorizations for this integration"**

This is an Airtable limitation that occurs during authorization and looks like this:

<figure><img src="https://2481481593-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtLaMDbvbGOow76E8CnqW%2Fuploads%2Fgit-blob-0ec8a6d9758695951317b506d6bbd34fde1c3968%2FCleanShot%202023-04-19%20at%2010.38.20.png?alt=media" alt=""><figcaption></figcaption></figure>

<mark style="color:green;">**Suggested Action:**</mark>

1. Delete old connections in Airtable
   1. Click on your account > "Integrations"

      <figure><img src="https://2481481593-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtLaMDbvbGOow76E8CnqW%2Fuploads%2Fgit-blob-35c207cfbccc952912806bec89b5cd79f8d38eca%2FIntegrations.png?alt=media" alt=""><figcaption></figcaption></figure>
   2. Click on "3rd party integrations" and start removing integrations

      <figure><img src="https://2481481593-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtLaMDbvbGOow76E8CnqW%2Fuploads%2Fgit-blob-f0ef00c92e227949be5c308c0578fc4d7cc0bd9d%2F3rd%20party.png?alt=media" alt=""><figcaption></figcaption></figure>

### 2) "Field 'slug': Unique value is already in database"

Other apps you might connect to Airtable (eg. Webflow) will often have a requirement that the `slug`field is unique.

<mark style="color:green;">**Suggested Action:**</mark>

1. We suggest using an Airtable formula to create slugs:

{% content-ref url="/pages/khw3ZdIZl5I7WYleF2WT" %}
[How to create a slug field in Airtable](/resources/support/how-to-create-a-slug-field-in-airtable.md)
{% endcontent-ref %}

### 3) "Airtable doesn't allow you to create records in their native "synced" tables."

Airtable has a native syncing feature called "[synced tables](https://support.airtable.com/docs/getting-started-with-airtable-sync)" that pulls data into an Airtable base.

You'll notice a little lightning bolt like this when using their synced tables feature:

<figure><img src="https://2481481593-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtLaMDbvbGOow76E8CnqW%2Fuploads%2Fgit-blob-624f76f9f151849a1db1f4718896c7e925e8c0de%2Fsynced%20table.png?alt=media" alt=""><figcaption><p>Example of an Airtable "synced table" using Airtable's native syncing features</p></figcaption></figure>

When using an Airtable synced table, **Airtable does not allow you to overwrite this data**. So if you set up a Whalesync 2-way sync, you will hit Airtable sync issues.

**How to Resolve**

* Either make this a 1-way sync to only sync data *out* of the Airtable synced table
* OR switch the table in Airtable to a normal "non-synced" table

### 4) "Invalid user permissions in Airtable."

Airtable is blocking Whalesync from making changes to your Airtable base due to permissions settings in Airtable.

**How to Resolve**

1. Go to your Airtable base and check the permissions of the user you authorized with

   <figure><img src="https://2481481593-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtLaMDbvbGOow76E8CnqW%2Fuploads%2Fgit-blob-d75275f5bf3a7f466bd027118218958a42f44ebd%2Fpermissions.png?alt=media" alt=""><figcaption><p>Your user will have your email address and not "founders@whalesync.coM"</p></figcaption></figure>
2. Check permissions in your Airtable Workspace settings

   <figure><img src="https://2481481593-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtLaMDbvbGOow76E8CnqW%2Fuploads%2Fgit-blob-3d1f2b004230b569c67727971863902c60bbcf6e%2FPermissions%202.png?alt=media" alt=""><figcaption></figcaption></figure>

   a. Confirm that your user has the ability to create and edit the Airtable base you authorized.
3. Check your Airtable Workspace sharing restrictions

   <figure><img src="https://2481481593-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtLaMDbvbGOow76E8CnqW%2Fuploads%2Fgit-blob-afbdeebb133d3f29c6522ace8e83ea07fb823ed9%2Fpermissions%203.png?alt=media" alt=""><figcaption></figcaption></figure>

### 5) "Your sync has been turned off due to some connection issues with Airtable for the past 7 days"

Whalesync automatically retries any issues that occur in your sync. However, if an Airtable connection issue remains unresolved for 7 days, the sync will be paused. To fix this, you would need to go to your sync with this issue and reauthorize your Airtable connection.

<figure><img src="https://2481481593-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtLaMDbvbGOow76E8CnqW%2Fuploads%2Fgit-blob-dc17a91d3f1bdc570b71d9a601b50924cf9ba14e%2FCleanShot%202025-10-11%20at%2002.46.28%402x.png?alt=media" alt=""><figcaption></figcaption></figure>
