Troubleshooting overview

If something isn't working in 2sync, start here. Identify your symptom below and jump to the right guide.

What kind of problem are you experiencing?

Symptom	Guide
"API Token Invalid", disconnected account, or can't reach Notion	Connection issues
Items not appearing, duplicates, wrong data, or missing fields	Sync problems
Automation halted with a deletion or duplicate warning	Safety limits
Specific error code on your dashboard	Error codes
Sync is slow or delayed	Rate limits and retries
Automation shows a red or yellow badge	Automation statuses
Need to understand per-item sync states in Notion	Sync item statuses
2sync appears down, or you want to check for scheduled maintenance	System status

Run through these checks before diving into a specific guide:

Is 2sync operational? Check status.2sync.com for outages or scheduled maintenance before troubleshooting your automation.
Is the automation active? Open your dashboard and verify the automation isn't paused, errored, or halted. See Automation statuses for what each badge means.
Are all connections valid? Go to Connections and confirm every connection shows as connected.
Is the item within your time window? Items outside your plan's sync window (past or future) won't sync. Check your time window in automation settings.
Does it match your filters? If you have filters configured, the item must meet all conditions to sync.
Check your Activity Logs: The Activity logs show exactly what 2sync did (or tried to do) in each sync cycle.

If you've worked through the relevant guide and the issue persists:

Go to app.2sync.com and open a support request
Include the following so we can help quickly:
- Automation name or ID (visible in your dashboard URL)
- Error messages or screenshots
- Steps you've already tried
- When the issue started