Fresh 2026

Troubleshooting

Common Merge integration issues and how to resolve them.

Authentication

Symptom	Likely cause	Fix
401 Unauthorized	Missing or wrong API key	Send Authorization: Bearer <API_KEY> from your backend
400 referencing account token	Missing account token	Send X-Account-Token for the target Linked Account
Works in test, fails in prod	Using a test account token in production	Use the production Linked Account's token

Data freshness

Symptom	Likely cause	Fix
Data looks stale	Waiting on the next scheduled sync	Check Sync Frequency; force a resync if needed
Re-fetching everything	Not using incremental sync	Add modified_after per Syncing Best Practices
Missing fields	Field not in the Common Model	Use Field Mapping or Remote Data

Writes

Symptom	Likely cause	Fix
Write rejected	Required field missing for that integration	Call /meta first; required fields vary by platform
Relation not created	Related record sent separately	Use Related and Nested Writes

Linked Accounts

Symptom	Likely cause	Fix
Account shows an issue	Credential or permission problem at the source	Check the Linked Account issues in the dashboard and prompt the user to re-auth
Endpoint returns empty	Scope not enabled	Review Scopes

Rate limits

Hitting limits returns 429. Back off and retry. See Rate Limits for limits by plan tier.

Related

• Authentication
• Common Requests