Manage duplicate detection for create and update operations

Dynamics 365 Customer Engagement Web API allows you to detect duplicate records of an existing record in order to maintain integrity of data.

Using Web API

Use Preference header MSCRM.SuppressDuplicateDetection and set its value to false to detect creation of a duplicate record during Create and Update operations.

Note

Make sure there are appropriate duplicate detection rules in place. Dynamics 365 Customer Engagement (on-premises) includes default duplicate detection rules for accounts, contacts, and leads, but not for other types of records. If you want the system to detect duplicates for other record types, you’ll need to create a new rule. For information on how to create a duplicate detection rule, see Duplicate detection rules.

For more information and examples on how to prohibit creation of duplicate records during create and update operations, see Manage duplicate detection for create and update operations using Web API.

Using Organization Service

Use SuppressDuplicateDetection parameter and set its value to false to activate duplicate detection and prohibit creation of a duplicate record during create and update operations.

For more information and example on how to prohibit creation of duplicate records during create and update operations, see Manage duplicate detection for create and update operations using Organization Service.

See Also

Manage duplicate detection during Create and Update operation using Web API
Manage duplicate detection during Create and Update operation using Organization Service
Sample: Use duplicate detection when creating and updating records
Sample: Detect multiple duplicate records
Run duplicate detection