๐ Fixing a broken Airtable token status
If your Airtable Token status is marked as broken, it means SyncBase can no longer access your Airtable base correctly. This usually happens after a change in Airtable permissions, ownership, or token configuration. The good news is that in most cases, the issue can be fixed quickly by checking a few specific points.
Below are the main reasons why an Airtable token can break, and how to resolve each one.
Why the Airtable token can be broken
Access scopes or resources were modified
If the access scopes or resources of the Airtable token used by SyncBase were changed after the initial setup, SyncBase may lose required permissions.
How to fix it
- Open your Airtable account.
- Edit the token used for SyncBase.
- Restore the scopes and resources exactly as they were during the initial SyncBase setup.
Airtable base ownership has changed
The Airtable token is linked to a specific Airtable account. If the ownership of the synced base has been transferred to another user, the original token will no longer have access.
How to fix it
- Make sure the base is owned by (or properly shared with) the Airtable account that created the token.
- If needed, generate a new token from the correct Airtable account and reconnect it in SyncBase.
Table or field-level permissions were added
If permissions were added on synced tables or specific fields, SyncBase may no longer be able to read, create, or update records.
How to fix it
- Review table and field permissions in Airtable.
- Ensure SyncBase has full access to all synced tables and fields.
- Remove restrictive permissions that block updates or record creation.
The Airtable token was deleted
If the Airtable token used by SyncBase has been deleted, SyncBase can no longer authenticate with Airtable at all.
How to fix it
- Create a new Airtable token with the required scopes and resources.
- Contact us through the in-app chat so we can help you validate everything and restore the connection properly.
Final step: refresh the status
Once you have checked and fixed the points above:
- Go back to the SyncBase app in Shopify.
- Refresh the Settings page.
- Check if the Airtable Token status is now marked as active.
If everything is correctly configured, the status should update automatically.
Updated on: 15/12/2025
Thank you!