Integration troubleshooting
Generic playbook for diagnosing any integration that's misbehaving.
When an integration looks broken, this list of checks resolves about 90% of issues.
First, check the sync log
Settings → Integrations → <integration> → Sync log shows the last 50 runs with status, duration, and error messages. Most issues are visible here.
Common failures
Auth expired — OAuth tokens for some providers expire after long periods of inactivity. The fix is always Reconnect.
Rate limited — Some providers (CompanyCam, GHL) have hourly request limits. SunrAI backs off automatically; nothing to do.
Record not found — A record was deleted on the provider side but is still referenced in SunrAI. Open the affected record and either re-link or archive.
Webhook delivery failure — The provider couldn't reach SunrAI. Check our status page for incidents; otherwise re-register webhooks from the integration's settings.
Force a re-sync
Open the integration page
Settings → Integrations → <name>.
Click 'Run sync now'
This kicks off an immediate full sync. For large datasets this may take 5–30 minutes.
Watch the sync log
Refresh the sync log every minute or two. The latest run should appear with "Running" then complete to "Success" or "Failed."
When nothing helps
Email support@sunrai.ai with:
- Integration name
- Sync log error message + timestamp
- One example record id that's affected
We can usually diagnose within one business day.