🚦 Sync status: monitor your connection health
Keeping an eye on your synchronization status helps ensure everything runs smoothly between Shopify and Airtable. The Status page gives you a complete overview of your connection, webhooks, queue, and errors — all in one place. If something feels slow or broken, this is the first place to check.
Access the Status page
In your SyncBase app, click on Status in the main menu.
You’ll see four main sections:
- Airtable token status
- Webhooks
- Tasks (queue)
- Errors monitoring
Each section helps you quickly identify where a potential issue may come from.
Airtable token status
This section shows whether your Airtable Personal Access Token is active.
What “Active” means
If the status is active, SyncBase can properly connect to:
- Your Airtable account
- Your Airtable-synced base
Everything is working on the authentication side âś…
If the token is “Broken” or “Inactive”
Synchronization cannot work without a valid token.
Common reasons:
- You deleted your Personal Access Token in Airtable
- You removed required scopes or permissions
- You changed the connected workspace
- You modified access to the synced base
If this happens, review your token configuration and permissions. If you’re unsure, contact us via the live chat — we’ll help you fix it quickly.
Webhooks
SyncBase relies on Shopify and Airtable webhooks to detect updates automatically.
When webhooks are active, updates made in Shopify or Airtable are instantly detected and synced.
Why some webhooks can be inactive
Your webhook status depends on your sync direction settings:
- Two-way sync → All required webhooks should be active
- One-way sync (Airtable → Shopify) → Shopify webhooks may be inactive (this is normal)
- One-way sync (Shopify → Airtable) → Airtable webhooks may be inactive (this is normal)
If you selected two-way sync and see inactive webhooks, a Refresh webhooks button will appear.
Click it to automatically re-register them.
If you’re using one-way sync, inactive webhooks can be totally expected.
Tasks (synchronization queue)
This section shows how many updates are currently waiting to be processed.
Why is there a queue?
Shopify and Airtable APIs have rate limits.
To stay within those limits, SyncBase:
- Stores updates in a queue
- Processes them one by one
For example:
- You run a bulk update in Airtable
- Then you edit one product manually
The single update will wait until all bulk updates are processed.
What to expect
If you see pending tasks:
- No worries — they are being processed
- You can refresh the counter to see if the number is decreasing
If the number is going down, everything is working normally.
Discard all tasks (with caution)
You can click Discard all tasks to clear the queue.
If your queue seems stuck, contact us via live chat before discarding tasks.
Errors monitoring
Each Airtable-synced base includes a dedicated Sync Errors table.
From the Status page, click Go to Errors tab to open it directly.
If a synchronization error occurs (for example):
- A required field was deleted
- A field format was changed
- An invalid value was entered
A detailed error record is created, including:
- The affected record
- The error message
- The cause
This helps you quickly understand and fix the issue.
Pro tip: Set up alerts
You can use Airtable Automations on the Sync Errors table to:
- Send email alerts
- Send Slack notifications
- Trigger internal workflows
This way, you’re immediately notified when something goes wrong.
When everything is green
If:
- Your Airtable token is active
- Required webhooks are active
- Your task queue is empty or decreasing
- No errors appear
Your synchronization is healthy and running smoothly 🚀
If anything looks unusual and you’re unsure what to do, feel free to reach out via the in-app live chat.
Updated on: 13/02/2026
Thank you!