Error codes & troubleshooting
Understand and resolve every error code in 2sync
2sync displays error codes on your automation dashboard when something prevents syncing. Each error has a specific cause and solution. Most errors resolve in under a minute once you identify the issue. Below is a complete reference grouped by category.
What are 2sync error codes?
Every error appears as a status badge on your automation card. Click the badge to see details and a direct link to the fix.
What are the subscription errors?
| Error | Cause | Solution |
|---|---|---|
| Quota Reached | More active automations than your plan allows | Upgrade your plan or pause unused automations |
| Unsubscribed | Subscription is inactive | Resubscribe to reactivate your automations |
Subscription errors affect all automations on your account. Resolving one fixes them all.
What are the connection errors?
| Error | Cause | Solution |
|---|---|---|
| Provider Not Connected | Google, Outlook, or Todoist connection expired | Go to Connections, verify and reconnect the provider |
| Notion Disconnected | Notion access token expired | Reconnect your Notion workspace |
| Different Workspace | Connected to a different Notion workspace than configured | Reconnect the same workspace or create a new automation |
What are the configuration errors?
| Error | Cause | Solution |
|---|---|---|
| No Asset Selected | No calendar, task list, or project selected | Select at least one asset in your automation settings |
| Missing Fields | Required Notion properties missing from the database | Add the missing properties to your Notion database |
| Unmapped Fields | Required fields not mapped in field mapping | Complete field mapping for all required fields |
| Incorrect Source Property | Source property is not a Select type | Change the property to a Select type in Notion |
What are the safety errors?
| Error | Cause | Solution |
|---|---|---|
| Halt: Multiple Deletion | About to delete more than 50% of synced items | Review pending changes; enable Bypass Halt if intentional |
| Halt: Duplicates | About to create duplicate entries | Check your data source for duplicates before continuing |
Safety halts protect your data. Only use Bypass Halt when you have confirmed the changes are intentional.
What are the size and rate limit errors?
| Error | Cause | Solution |
|---|---|---|
| Too Many Notion Entries | Notion database exceeds the recommended size | Reduce the sync timeframe or upgrade your plan |
| Too Many Calendar Events | Too many events in the sync time window | Reduce the timeframe or upgrade your plan |
| Too Many Contacts | Contact count exceeds plan limits | Upgrade to Premium |
| Too Many Emails | Email count exceeds plan limits | Reduce the timeframe or upgrade your plan |
| Google Contacts Limit | Google enforces a 25,000 contact maximum | Remove contacts including those in trash |
| Rate Limited | Too many Notion API requests in a short period | Wait a few minutes and retry |
What are the Notion-specific errors?
| Error | Cause | Solution |
|---|---|---|
| Database Deleted | Notion database is in the trash | Restore the database from Notion's trash |
| Database Not Connected | 2sync lacks permission to access the database | Add the 2sync connection to your Notion database |
| Relation Access Error | A relation property links to an inaccessible database | Share the linked database with 2sync |
| Status Value Missing | A status value does not exist in the database | Add the missing status option in Notion |
| Invalid Emoji | Default emoji is incompatible with Notion | Choose a different emoji |
| Body Validation | A field or default value is not properly mapped | Check your mappings and default values |
What are the sync status errors?
| Error | Cause | Solution |
|---|---|---|
| Sync Already Running | A sync cycle is already in progress | Wait for the current sync to finish |
| Sync Paused | Automation was manually paused | Resume from your dashboard |
| Sync Aborted | Sync was interrupted temporarily | No action needed; the next sync proceeds normally |
| Automation Timeout | High system load caused a timeout | No action needed; the next sync proceeds normally |
How to resolve errors quickly
- Open your automation and read the error badge
- Match the error to the tables above
- Follow the solution column
- Click Sync Now to verify the fix
Most errors clear automatically after the underlying issue is resolved and the next sync runs.
Most errors auto-resolve after you fix the underlying issue. Check your activity logs for a history of errors and resolutions to identify recurring patterns.
Related
- Troubleshooting overview for finding the right guide when you're not sure where to start
- Automation statuses for understanding status badges on your dashboard
- Connection issues for troubleshooting authentication and permission problems
- Rate limits and retries for understanding Rate Limited errors
- Safety limits for understanding halt-related errors
- Sync problems for general troubleshooting steps
FAQ
How do I know which error my automation has?
Open your 2sync dashboard. Each automation shows a status badge. Click the badge to see the specific error code and a description of the issue.
What does Halt: Multiple Deletion mean?
This safety feature activates when 2sync detects it would delete more than 50% of your synced items. Review the pending changes carefully. If the deletions are intentional, enable Bypass Halt in your sync settings.
Why does my Notion connection keep disconnecting?
Notion access tokens expire periodically. Reconnect your workspace from the Connections page. If it happens frequently, check that 2sync still has access to all required databases in your Notion settings.
Can I ignore the Rate Limited error?
Yes. Rate limiting is temporary and resolves on its own. 2sync automatically retries with exponential backoff. Your next sync cycle will proceed normally.
What happens to my data when an error occurs?
Nothing is lost. Errors pause syncing but do not delete or modify existing data. Once you resolve the error, syncing resumes from where it stopped.
Why am I getting the 'API token invalid' error?
This error means 2sync's connection to Notion has expired or been revoked. Reconnect Notion from the Connections page in your 2sync dashboard. See the connection issues guide for step-by-step instructions.
What does the error 'Cannot read properties of undefined (reading type)' mean?
This error occurs when a Notion property type has been changed after the automation was configured. For example, changing a Select to a Multi-select. Revert the property to its original type, or update the field mapping in your automation to match the new type.