Why did a merge fail?

Last updated: June 22, 2026

A merge can fail because Salesforce rejected the operation. Common causes include permissions, validation rules, duplicate rules, related object handling, record locks, or package/configuration issues.

The Salesforce error is the starting point for diagnosis.

Check first

  • What exact error did Salesforce return?

  • Which user or integration user ran the merge?

  • Are validation rules or duplicate rules active?

  • Are custom related objects involved?

  • Is the package/configuration current?

Related product docs