Five errors cover 90% of cases: expired auth, permission gaps, rate limits, mapping mismatches, and webhook delivery failures. Each has a distinct signature in the sync log and a standard fix.
Expired or revoked auth
Signature: sudden total sync stop, 401s in the log. Cause: password change, token revocation, or admin deprovisioning the integration user. Fix: re-authenticate from the integration page — takes a minute.
Permission gaps
Signature: partial failures on specific objects ("cannot write Opportunity"). Cause: integration user lacks object/field permissions. Fix: grant in the CRM admin; the error names the exact missing permission.
Rate limits
Signature: throttled batches, sync lag but no errors. Normal for large syncs on limited API plans. Fix: usually nothing — turgo backs off and completes. Persistent lag: raise the CRM API tier or narrow sync scope.
Mapping and webhook issues
Mapping mismatch: value rejected ("picklist value not found") — update the translation table. Webhook failures: check endpoint reachability and signature config; turgo retries with backoff for 24 hours.
