๐ต๏ธ Monitoring errors with the Errors sync tab
The "Errors sync" tab helps you monitor and manage issues that may occur during synchronization between Shopify and Airtable. It's your go-to place to understand what went wrong and how to fix it.
How the "Errors sync" tab works
- SyncBase automatically creates a tab called
Errors sync
. - Do not delete it โ itโs essential for tracking sync issues.
- Each error is represented by one record.
- A record includes: Error type, Linked Airtable record, Process ID, Timestamp...
What to do when an error occurs
- Check if the error resolved itself
Example: If an order had an invalid shipping address and you corrected it, the error may have already disappeared automatically.
- Review the error details
- Look at all the fields in the error record.
- Identify the operation that caused the issue.
- Check the
Error cause
field
- It usually gives a clear explanation of the issue.
- Most of the time, it also tells you what needs to be corrected.
- Still stuck?
- Contact us directly via the live chat or at [support@syncbase.app](). Weโre happy to help.
List of errors
INVALID_PERMISSIONS_OR_MODEL_NOT_FOUND
๐ Cause: Usually this means that there's been an attempt to access or modify a record that does not exist anymore. It can happen when we receive a Shopify update but the related record got deleted.
Value is invalid JSON
๐ Cause: When it comes to metafields, this usually means the value you're entering doesn't match the format expected by Shopify.
โ Solution: The easiest way to understand the correct format is to do the reverse:
- Add a value directly in Shopify.
- Save it.
- Check how that value appears in your synced Airtable base.
This will show you the format Shopify expects, so you can replicate it when editing from Airtable.
AMBIGUOUS_FIELD_NAMES
๐ Cause: You're trying to create a field with an already existing name (a synced or unsynced column).
โ Solution: Just try another name
Updated on: 10/07/2025
Thank you!