Find and troubleshoot sync failures

Choose the page for the failing phase. Check its symptom and fix, then rerun the affected operation.

Symptoms

Deployment version never becomes ready

See Deployment troubleshooting.

Package slug conflict

See Deployment troubleshooting.

CLI token expired or wrong organization selected

See Deployment troubleshooting.

Connection passes verification but extraction is unauthorized

See Extraction troubleshooting.

Fixture completes but records are wrong or missing

See Extraction troubleshooting.

Only the first API page is imported

See Extraction troubleshooting.

Incremental sync misses records or reimports everything

See Extraction troubleshooting.

Metadata and normalized records disagree

See Mapping and identity troubleshooting.

Required fields are missing after mapping

See Mapping and identity troubleshooting.

Duplicate records or repeated reverse-sync writes

See Mapping and identity troubleshooting.

Worker emits twice or never finishes

See Runtime troubleshooting.

SDK upgrade compiles but behavior changed

See Runtime troubleshooting.

Attachments absent while records are present

See Attachment troubleshooting.