Duplicate Search Settings for Any Fields: Overview of Methods

If you are developing integrations for Bitrix24 using AI tools (Codex, Claude Code, Cursor), connect to the MCP server so that the assistant can utilize the official REST documentation.

When there are many leads, contacts, and companies in the CRM, duplicates arise due to incomplete or inconsistently filled data.

The methods crm.duplicate.volatileType.* extend the standard duplicate check and allow for the configuration of additional fields.

To search for duplicates based solely on phone numbers and emails, use crm.duplicate.findbycomm.

Quick Navigation: All Methods

User Documentation: Searching and Handling Duplicates in Bitrix24

Connection of Duplicate Search Settings with CRM Entities

The entityTypeId parameter specifies the type of CRM entity and determines which objects the methods work with regarding additional search fields.

CRM Entity Type

entityTypeId

Lead

1

Contact

3

Company

4

Important Considerations

  • You can register no more than 7 custom fields in total for all entity types.
  • To remove a field, you need the id of the record, which is returned by crm.duplicate.volatileType.list.

How to Configure Search by Additional Fields

  1. Retrieve the available fields using the method crm.duplicate.volatileType.fields.
  2. Check the current connections via crm.duplicate.volatileType.list.
  3. Add the required field using the method crm.duplicate.volatileType.register.
  4. Re-invoke crm.duplicate.volatileType.list and check the result.
  5. Remove the field using the method crm.duplicate.volatileType.unregister if it is no longer needed.

Overview of Methods

Scope: crm

Who can execute the methods: administrator

Method

Description

crm.duplicate.volatileType.fields

Returns a list of standard and custom fields for duplicate searches

crm.duplicate.volatileType.list

Returns a list of additional fields already connected to duplicate searches

crm.duplicate.volatileType.register

Adds a field to the duplicate search settings

crm.duplicate.volatileType.unregister

Removes a field from the duplicate search settings