Articles on: Troubleshooting

๐Ÿ•ต๏ธ 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


  1. 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.


  1. Review the error details


  • Look at all the fields in the error record.
  • Identify the operation that caused the issue.


  1. 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.


  1. Still stuck?
  • Contact us directly via the live chat or at [support@syncbase.app](). Weโ€™re happy to help.


Once the issue is fixed, you can safely delete the error record.


List of errors


Weโ€™re working on a detailed list of common errors. For each one, youโ€™ll find: 1) What it means 2) Why it happens 3) What to do to fix it


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:


  1. Add a value directly in Shopify.
  2. Save it.
  3. 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

Was this article helpful?

Share your feedback

Cancel

Thank you!