Add Repeat Lead

Scope: crm

Who can execute the methods: to complete the entire scenario, the strictest of the listed rights is required — permission to create leads

crm.duplicate.findbycomm — a user with permission to read CRM items

crm.lead.list — a user with permission to read leads

crm.lead.add — a user with permission to create leads

Choose a tool for developing with an AI agent:

use Alaio Vibecode to build an app for Bitrix24 from a task description without knowing any programming language. The agent writes the code and deploys the app to a server, with no manual hosting setup
use the MCP server to develop a REST API integration in your own project. The agent refers to the official REST documentation

When a customer fills out a form on a site, their data is sent to a handler. The script searches the CRM for matches by phone number or email address among leads, contacts, and companies. If matches are found, the lead is marked as a repeat lead and linked to the existing record. This approach helps avoid duplicates and increases manager efficiency.

As a result of the scenario, a new lead appears in the CRM. If the customer has contacted you before, the lead has the COMPANY_ID and CONTACT_ID fields filled in — the link to the company and the contact that resulted from the previous request.

Repeat lead mode must be enabled in Bitrix24. For more details, read the article Repeat Leads and Deals.

The setup consists of two stages:

Prepare the fields and place the form on the page
Create a handler file that sequentially calls the crm.duplicate.findbycomm, crm.lead.list, and crm.lead.add methods

Before You Start

Repeat lead mode is enabled in Bitrix24. Without it, the lead is still created but does not become a repeat lead
The webhook is created on behalf of a user with permission to create leads and to read CRM items
You have a server that serves the page with the form and accepts the form data using the POST method. In the examples, this is Express for JS, a PHP script, and Flask for Python
The webhook URL is stored in the environment, not in the page code. The form is on a public page, and the secret must not end up in it

1. Create a Web Form

Create an HTML form with the following fields:

NAME — customer name, required field
LAST_NAME — surname
PHONE — phone
EMAIL — Email

The form sends data to the handler using the POST method.

How to Use Examples in Documentation

Python

PHP

<form id="form_to_crm">
            <input type="text" name="NAME" placeholder="Name" required>
            <input type="text" name="LAST_NAME" placeholder="Last name">
            <input type="text" name="PHONE" placeholder="Phone">
            <input type="text" name="EMAIL" placeholder="E-mail">
            <input type="submit" value="Submit">
        </form>
        
        <script>
            document.getElementById('form_to_crm').addEventListener('submit', async (el) => {
                el.preventDefault();
                const formData = Object.fromEntries(new FormData(el.currentTarget).entries());
                const response = await fetch('/form', {
                    method: 'POST',
                    headers: { 'Content-Type': 'application/json' },
                    body: JSON.stringify(formData),
                });
                const data = await response.json();
                alert(data.message);
            });
        </script>

<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
        <script>
        $(document).ready(function() {
            $('#form_to_crm').on( 'submit', function(el) {//event submit form
                el.preventDefault();//the default action of the event will not be triggered
                var formData = $(this).serialize();
                $.ajax({
                    'method': 'POST',
                    'dataType': 'json',
                    'url': '/form', // Flask handler route
                    'data': formData,
                    success: function(data){//success callback
                        alert(data.message);
                    }
                });
            });
        });
        </script>
        
        <form id="form_to_crm">
            <input type="text" name="NAME" placeholder="Name" required>
            <input type="text" name="LAST_NAME" placeholder="Last name">
            <input type="text" name="PHONE" placeholder="Phone">
            <input type="text" name="EMAIL" placeholder="E-mail">
            <input type="submit" value="Submit">
        </form>

<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
        <script>
        $(document).ready(function() {
            $('#form_to_crm').on( 'submit', function(el) {//event submit form
                el.preventDefault();//the default action of the event will not be triggered
                var formData = $(this).serialize();
                $.ajax({
                    'method': 'POST',
                    'dataType': 'json',
                    'url': 'form.php', // file for saving filled forms
                    'data': formData,
                    success: function(data){//success callback
                        alert(data.message);
                    }
                });
            });
        });
        </script>
        
        <form id="form_to_crm">
            <input type="text" name="NAME" placeholder="Name" required>
            <input type="text" name="LAST_NAME" placeholder="Last name">
            <input type="text" name="PHONE" placeholder="Phone">
            <input type="text" name="EMAIL" placeholder="E-mail">
            <input type="submit" value="Submit">
        </form>

2. Creating a Form Handler

Create a handler. It will process the data, check for duplicates, and create a lead.

Retrieving Data from the Form

Retrieve and safely process data from the NAME, LAST_NAME, PHONE, and EMAIL fields to prevent XSS attacks.

Python

PHP

const sName = String(req.body.NAME ?? '')
        const sLastName = String(req.body.LAST_NAME ?? '')
        const sPhone = String(req.body.PHONE ?? '')
        const sEmail = String(req.body.EMAIL ?? '')

s_name = request.form.get("NAME", "")
        s_last_name = request.form.get("LAST_NAME", "")
        s_phone = request.form.get("PHONE", "")
        s_email = request.form.get("EMAIL", "")

$sName = htmlspecialchars($_POST["NAME"]);
        $sLastName = htmlspecialchars($_POST["LAST_NAME"]);
        $sPhone = htmlspecialchars($_POST["PHONE"]);
        $sEmail = htmlspecialchars($_POST["EMAIL"]);

Form an $arFields array with the new lead data.

Python

PHP

const arFields = {
            TITLE: 'From the site: ' + [sName, sLastName].join(' '),
            NAME: sName || 'Empty name',
            LAST_NAME: sLastName,
            PHONE: sPhone ? [{ VALUE: sPhone, VALUE_TYPE: 'HOME' }] : [],
            EMAIL: sEmail ? [{ VALUE: sEmail, VALUE_TYPE: 'HOME' }] : [],
        }

ar_fields = {
            "TITLE": "From the site: " + " ".join([s_name, s_last_name]),
            "NAME": s_name or "Empty name",
            "LAST_NAME": s_last_name,
            "PHONE": [{"VALUE": s_phone, "VALUE_TYPE": "HOME"}] if s_phone else [],
            "EMAIL": [{"VALUE": s_email, "VALUE_TYPE": "HOME"}] if s_email else [],
        }

$arFields = [
            'TITLE' => 'From the site: ' . implode(' ', [$sName, $sLastName]),
            'NAME' => (!empty($sName)) ? $sName : 'Empty name',
            'LAST_NAME' => $sLastName,
            'PHONE' => (!empty($sPhone)) ? array(array('VALUE' => $sPhone, 'VALUE_TYPE' => 'HOME')) : array(),
            'EMAIL' => (!empty($sEmail)) ? array(array('VALUE' => $sEmail, 'VALUE_TYPE' => 'HOME')) : array()
        ];

Form the lead heading as From the site: First Name Last Name.

The system stores phone numbers and email addresses as arrays of crm_multifield objects, so we form the PHONE and EMAIL arrays using the $sPhone and $sEmail values.

Write $sPhone and $sEmail to the VALUE fields
Pass types, such as HOME, to the VALUE_TYPE fields

If the $sPhone and $sEmail variables do not contain values, specify empty arrays.

Searching for Lead Duplicates

To find repeat leads by phone number and email address, call the crm.duplicate.findbycomm method twice. You must pass the following data to it:

entity_type — the object type. Pass LEAD — lead
type — the communication type. Specify PHONE during the first call and EMAIL during the second
values — an array of values to search for. In the call with type: PHONE, pass the phone number $sPhone; in the call with type: EMAIL, pass the email address $sEmail. Both values are retrieved from the form

We will accumulate the identifiers of the duplicates found in the $arLeadDuplicate array. Declare it before the first call.

Searching by phone, "type" => "PHONE".

Python

PHP

let arLeadDuplicate = []
        
        if (sPhone) {
            const resultDuplicate = await $b24.actions.v2.call.make({
                method: 'crm.duplicate.findbycomm',
                params: { entity_type: 'LEAD', type: 'PHONE', values: [sPhone] },
                requestId: 'dup-phone'
            })
            const found = resultDuplicate.getData()?.result?.LEAD
            if (found) arLeadDuplicate = arLeadDuplicate.concat(found)
        }

ar_lead_duplicate = []
        
        if s_phone:
            result_duplicate = client.crm.duplicate.findbycomm(
                type="PHONE", values=[s_phone], entity_type="LEAD",
            ).result
            # if there are no matches, the method returns an empty array rather than
            # an object, so cast the result to a dictionary before accessing the key
            found = (result_duplicate or {}).get("LEAD")
            if found:
                ar_lead_duplicate += found

$arLeadDuplicate = [];
        
        if (!empty($sPhone)) {
            $result = $sb->getCRMScope()->duplicate()->findByPhone(
                [$sPhone],
                \Bitrix24\SDK\Services\CRM\Duplicates\Service\EntityType::Lead
            )->getCoreResponse()->getResponseData()->getResult();
            if (!empty($result['LEAD'])) {
                $arLeadDuplicate = array_merge($arLeadDuplicate, $result['LEAD']);
            }
        }

Searching for duplicates by email, "type" => "EMAIL".

Python

PHP

if (sEmail) {
            const resultDuplicate = await $b24.actions.v2.call.make({
                method: 'crm.duplicate.findbycomm',
                params: { entity_type: 'LEAD', type: 'EMAIL', values: [sEmail] },
                requestId: 'dup-email'
            })
            const found = resultDuplicate.getData()?.result?.LEAD
            if (found) arLeadDuplicate = arLeadDuplicate.concat(found)
        }

if s_email:
            result_duplicate = client.crm.duplicate.findbycomm(
                type="EMAIL", values=[s_email], entity_type="LEAD",
            ).result
            found = (result_duplicate or {}).get("LEAD")
            if found:
                ar_lead_duplicate += found

if (!empty($sEmail)) {
            $result = $sb->getCRMScope()->duplicate()->findByEmail(
                [$sEmail],
                \Bitrix24\SDK\Services\CRM\Duplicates\Service\EntityType::Lead
            )->getCoreResponse()->getResponseData()->getResult();
            if (!empty($result['LEAD'])) {
                $arLeadDuplicate = array_merge($arLeadDuplicate, $result['LEAD']);
            }
        }

If matches are found, the method returns an object with the LEAD key and an array of identifiers.

{
            "result": {
                "LEAD": [3277, 3281]
            }
        }

If there are no matches, the method returns an empty array rather than an empty object. You cannot access the LEAD key directly — check the type of the result first, otherwise the code crashes on the very first request without duplicates.

{
            "result": []
        }

Combine the identifiers of the found duplicates into the $arLeadDuplicate array.

Processing Duplicates

If duplicates are found, call the crm.lead.list method.

Apply a filter by identifier and status CONVERTED
Select the fields: ID, COMPANY_ID, CONTACT_ID
Retain the result in the $arDuplicateLead array
Fill the COMPANY_ID and CONTACT_ID fields in the $arFields array with values from $arDuplicateLead

The CONVERTED status selects only those leads that have already been converted into a contact or a company. Other leads have empty COMPANY_ID and CONTACT_ID fields, so there is nothing to link the new lead to.

Python

PHP

if (arLeadDuplicate.length) {
            const duplicateLead = await $b24.actions.v2.callList.make({
                method: 'crm.lead.list',
                params: {
                    filter: { '=ID': arLeadDuplicate, STATUS_ID: 'CONVERTED' },
                    select: ['ID', 'COMPANY_ID', 'CONTACT_ID']
                },
                requestId: 'dup-lead-list'
            })
            const arDuplicateLead = duplicateLead.getData()?.result ?? []
            const company = arDuplicateLead.map(r => r.COMPANY_ID).find(v => v > 0)
            const contact = arDuplicateLead.map(r => r.CONTACT_ID).find(v => v > 0)
            if (company) arFields.COMPANY_ID = company
            if (contact) arFields.CONTACT_ID = contact
        }

if ar_lead_duplicate:
            ar_duplicate_lead = client.crm.lead.list(
                filter={"=ID": ar_lead_duplicate, "STATUS_ID": "CONVERTED"},
                select=["ID", "COMPANY_ID", "CONTACT_ID"],
            ).as_list().result
        
            company = next((r["COMPANY_ID"] for r in ar_duplicate_lead if int(r["COMPANY_ID"] or 0) > 0), None)
            contact = next((r["CONTACT_ID"] for r in ar_duplicate_lead if int(r["CONTACT_ID"] or 0) > 0), None)
            if company:
                ar_fields["COMPANY_ID"] = company
            if contact:
                ar_fields["CONTACT_ID"] = contact

if (!empty($arLeadDuplicate)) {
            $arDuplicateLead = [];
            foreach ($sb->getCRMScope()->lead()->batch->list(
                order: [],
                filter: ['=ID' => $arLeadDuplicate, 'STATUS_ID' => 'CONVERTED'],
                select: ['ID', 'COMPANY_ID', 'CONTACT_ID']
            ) as $lead) {
                $arDuplicateLead[] = $lead;
            }
        
            foreach ($arDuplicateLead as $lead) {
                if ($lead->COMPANY_ID > 0 && empty($arFields['COMPANY_ID'])) {
                    $arFields['COMPANY_ID'] = $lead->COMPANY_ID;
                }
                if ($lead->CONTACT_ID > 0 && empty($arFields['CONTACT_ID'])) {
                    $arFields['CONTACT_ID'] = $lead->CONTACT_ID;
                }
            }
        }

The method returns identifiers as strings, and empty links as null. That is why we check the values before moving them into $arFields.

{
            "result": [
                {
                    "ID": "3277",
                    "COMPANY_ID": "1789",
                    "CONTACT_ID": "2431"
                }
            ],
            "total": 1
        }

Adding a New Lead

To add a lead, use the crm.lead.add method. Pass the $arFields array to it — with the fields from the form and with COMPANY_ID and CONTACT_ID, if duplicates were found.

Check which mandatory fields are configured for leads in your Bitrix24. All mandatory fields must be passed to the crm.lead.add method.

Python

PHP

await $b24.actions.v2.call.make({
            method: 'crm.lead.add',
            params: { fields: arFields },
            requestId: 'repeat-lead-add'
        })

client.crm.lead.add(fields=ar_fields)

$sb->getCRMScope()->lead()->add($arFields);

If the lead is created successfully, the method will return its identifier. If you receive error error, review the possible error descriptions in the crm.lead.add method documentation.

{
            "result": 3289
        }

Verify the Result

Open the created lead in Bitrix24. For a repeat lead, the "Client" block in the card is filled in: it shows the company and the contact from the previous request.

Through REST, the lead is checked with the crm.lead.get method using the identifier from the response of the previous step.

Python

PHP

const checkResponse = await $b24.actions.v2.call.make({
            method: 'crm.lead.get',
            params: { id: 3289 },
            requestId: 'lead-get'
        })
        
        console.dir(checkResponse.getData().result)

lead = client.crm.lead.get(bitrix_id=3289).result

$lead = $sb->getCRMScope()->lead()->get(3289)->lead();

The scenario is complete if the response has:

TITLE starting with From the site: — the lead came from the form
PHONE and EMAIL matching what the form submitted
COMPANY_ID and CONTACT_ID filled in when the customer has contacted you before. For a first request, these fields remain empty, and this is also a correct result — there is nothing to link the lead to

The easiest way to check that the scenario worked specifically as duplicate search is this: submit the form twice with the same phone number. Between submissions, convert the first lead into a contact or a company, otherwise the filter by the CONVERTED status will not find it and the second lead will be created without links.

Errors and Diagnostics

If the method returns an error, check the request data.

Code	Reason and action
`403` `Access denied`	The user does not have permission to read CRM items or to create leads. Check which user the webhook was created on behalf of
`400` `Communication type is not defined`	The required `type` parameter was not passed to crm.duplicate.findbycomm. It is needed in each of the two calls
`400` `Communication values is not defined`	The required `values` parameter was not passed to crm.duplicate.findbycomm. If the form field is empty, skip the call rather than sending it with an empty array
`400` `Communication type '{type}' is not supported in current context`	A value other than `PHONE` or `EMAIL` was passed in `type`

The lead may be created without an error but without links to a company and a contact. This is not a scenario failure but one of its outcomes. Check the following in order:

crm.duplicate.findbycomm returned an empty result. There are no matches by phone number or email address in the CRM, the customer is contacting you for the first time
Duplicates were found, but crm.lead.list returned an empty list. None of the leads found have the CONVERTED status — they have not yet been converted into a contact or a company
The search ignores the phone extension but is sensitive to the recording format. If the phone number is retained in the CRM as +49 30 1234567 and the form submitted 49301234567, there will be no match

Repeat the scenario from the step that returned the error. Duplicate search and list retrieval do not create anything, so they can be executed any number of times. If crm.lead.add returned the error, the lead was not created: fix the fields and repeat only that call.

Key Considerations

The crm.duplicate.findbycomm method accepts no more than 20 values in values per call
If 20 or more duplicates are found for one object type, the other types are not returned in the response. This does not interfere with the scenario: we search only by LEAD
The scenario links the new lead to a company and a contact, but it does not modify the old lead itself and does not merge duplicates. To merge them, use the crm.entity.mergeBatch method
Submitting the form again with the same data creates a new lead every time. Duplicates are not filtered out, the search is needed only for linking
The search covers leads only, because LEAD is passed in entity_type. To find matches among contacts and companies as well, remove entity_type — then the method returns an object with the LEAD, CONTACT, and COMPANY keys

Full Handler Code Example

Python

PHP

import express from 'express'
        import { B24Hook } from '@bitrix24/b24jssdk'
        
        const $b24 = B24Hook.fromWebhookUrl(process.env.B24_HOOK)
        // B24_HOOK = 'https://your-domain.bitrix24.com/rest/USER_ID/TOKEN/'
        
        const app = express()
        app.use(express.json())
        
        // Handler accepts form data via the /form route
        app.post('/form', async (req, res) => {
            const sName = String(req.body.NAME ?? '')
            const sLastName = String(req.body.LAST_NAME ?? '')
            const sPhone = String(req.body.PHONE ?? '')
            const sEmail = String(req.body.EMAIL ?? '')
        
            const arFields = {
                TITLE: 'From the site: ' + [sName, sLastName].join(' '),
                NAME: sName || 'Empty name',
                LAST_NAME: sLastName,
                PHONE: sPhone ? [{ VALUE: sPhone, VALUE_TYPE: 'HOME' }] : [],
                EMAIL: sEmail ? [{ VALUE: sEmail, VALUE_TYPE: 'HOME' }] : [],
            }
        
            let arLeadDuplicate = []
            if (sPhone) { // search for duplicates by phone number
                const r = await $b24.actions.v2.call.make({
                    method: 'crm.duplicate.findbycomm',
                    params: { entity_type: 'LEAD', type: 'PHONE', values: [sPhone] },
                    requestId: 'dup-phone'
                })
                const found = r.getData()?.result?.LEAD
                if (found) arLeadDuplicate = arLeadDuplicate.concat(found)
            }
        
            if (sEmail) { // search for duplicates by email
                const r = await $b24.actions.v2.call.make({
                    method: 'crm.duplicate.findbycomm',
                    params: { entity_type: 'LEAD', type: 'EMAIL', values: [sEmail] },
                    requestId: 'dup-email'
                })
                const found = r.getData()?.result?.LEAD
                if (found) arLeadDuplicate = arLeadDuplicate.concat(found)
            }
        
            if (arLeadDuplicate.length) { // get lead duplicate with fields of associated contact and company
                const duplicateLead = await $b24.actions.v2.callList.make({
                    method: 'crm.lead.list',
                    params: {
                        filter: { '=ID': arLeadDuplicate, STATUS_ID: 'CONVERTED' },
                        select: ['ID', 'COMPANY_ID', 'CONTACT_ID']
                    },
                    requestId: 'dup-lead-list'
                })
                const arDuplicateLead = duplicateLead.getData()?.result ?? []
                const company = arDuplicateLead.map(r => r.COMPANY_ID).find(v => v > 0)
                const contact = arDuplicateLead.map(r => r.CONTACT_ID).find(v => v > 0)
                if (company) arFields.COMPANY_ID = company
                if (contact) arFields.CONTACT_ID = contact
            }
        
            const result = await $b24.actions.v2.call.make({ // create repeat lead
                method: 'crm.lead.add',
                params: { fields: arFields },
                requestId: 'repeat-lead-add'
            })
        
            if (result.isSuccess && result.getData()?.result) {
                res.json({ message: 'Lead add' })
            } else {
                res.json({ message: 'Lead not added: ' + result.getErrorMessages().join('; ') })
            }
        })
        
        app.listen(3000)

# pip install b24pysdk flask
        from flask import Flask, request, jsonify
        from b24pysdk import BitrixWebhook, Client
        
        app = Flask(__name__)
        
        client = Client(BitrixWebhook(
            domain="your-domain.bitrix24.com",
            webhook_token="USER_ID/TOKEN",  # user_id/token only, without https://
        ))
        
        
        def find_lead_duplicates(comm_type: str, value: str) -> list:
            """Returns the identifiers of leads with a matching phone number or email address.
        
            If there are no matches, the method returns an empty array rather than an object,
            so cast the result to a dictionary before accessing the key.
            """
            result = client.crm.duplicate.findbycomm(
                type=comm_type, values=[value], entity_type="LEAD",
            ).result
            return (result or {}).get("LEAD") or []
        
        
        @app.route("/form", methods=["POST"])
        def handle_form():
            s_name = request.form.get("NAME", "")
            s_last_name = request.form.get("LAST_NAME", "")
            s_phone = request.form.get("PHONE", "")
            s_email = request.form.get("EMAIL", "")
        
            ar_fields = {
                "TITLE": "From the site: " + " ".join([s_name, s_last_name]),
                "NAME": s_name or "Empty name",
                "LAST_NAME": s_last_name,
                "PHONE": [{"VALUE": s_phone, "VALUE_TYPE": "HOME"}] if s_phone else [],
                "EMAIL": [{"VALUE": s_email, "VALUE_TYPE": "HOME"}] if s_email else [],
            }
        
            ar_lead_duplicate = []
            if s_phone:  # search for duplicates by phone number
                ar_lead_duplicate += find_lead_duplicates("PHONE", s_phone)
        
            if s_email:  # search for duplicates by email
                ar_lead_duplicate += find_lead_duplicates("EMAIL", s_email)
        
            if ar_lead_duplicate:  # get lead duplicate with fields of associated contact and company
                ar_duplicate_lead = client.crm.lead.list(
                    filter={"=ID": ar_lead_duplicate, "STATUS_ID": "CONVERTED"},
                    select=["ID", "COMPANY_ID", "CONTACT_ID"],
                ).as_list().result
                company = next((r["COMPANY_ID"] for r in ar_duplicate_lead if int(r["COMPANY_ID"] or 0) > 0), None)
                contact = next((r["CONTACT_ID"] for r in ar_duplicate_lead if int(r["CONTACT_ID"] or 0) > 0), None)
                if company:
                    ar_fields["COMPANY_ID"] = company
                if contact:
                    ar_fields["CONTACT_ID"] = contact
        
            try:
                client.crm.lead.add(fields=ar_fields)  # create repeat lead
                return jsonify({"message": "Lead add"})
            except Exception as e:
                return jsonify({"message": f"Lead not added: {e}"})

<?php
        // composer require bitrix24/b24phpsdk:"^3.0"
        require_once 'vendor/autoload.php';
        
        use Bitrix24\SDK\Services\ServiceBuilderFactory;
        use Bitrix24\SDK\Services\CRM\Duplicates\Service\EntityType;
        use Symfony\Component\EventDispatcher\EventDispatcher;
        use Monolog\Logger;
        use Monolog\Handler\StreamHandler;
        
        $log = new Logger('b24');
        $log->pushHandler(new StreamHandler('php://stdout'));
        
        $sb = (new ServiceBuilderFactory(new EventDispatcher(), $log))
            ->initFromWebhook('https://your-domain.bitrix24.com/rest/USER_ID/TOKEN/');
        
        $sName = htmlspecialchars($_POST["NAME"]);
        $sLastName = htmlspecialchars($_POST["LAST_NAME"]);
        $sPhone = htmlspecialchars($_POST["PHONE"]);
        $sEmail = htmlspecialchars($_POST["EMAIL"]);
        
        $arFields = [
            'TITLE' => 'From the site: ' . implode(' ', [$sName, $sLastName]),
            'NAME' => (!empty($sName)) ? $sName : 'Empty name',
            'LAST_NAME' => $sLastName,
            'PHONE' => (!empty($sPhone)) ? array(array('VALUE' => $sPhone, 'VALUE_TYPE' => 'HOME')) : array(),
            'EMAIL' => (!empty($sEmail)) ? array(array('VALUE' => $sEmail, 'VALUE_TYPE' => 'HOME')) : array()
        ];
        
        $arLeadDuplicate = [];
        if (!empty($sPhone)) { // search for duplicates by phone number
            $r = $sb->getCRMScope()->duplicate()->findByPhone([$sPhone], EntityType::Lead)
                ->getCoreResponse()->getResponseData()->getResult();
            if (!empty($r['LEAD'])) {
                $arLeadDuplicate = array_merge($arLeadDuplicate, $r['LEAD']);
            }
        }
        
        if (!empty($sEmail)) { // search for duplicates by email
            $r = $sb->getCRMScope()->duplicate()->findByEmail([$sEmail], EntityType::Lead)
                ->getCoreResponse()->getResponseData()->getResult();
            if (!empty($r['LEAD'])) {
                $arLeadDuplicate = array_merge($arLeadDuplicate, $r['LEAD']);
            }
        }
        
        if (!empty($arLeadDuplicate)) { // get lead duplicate with fields of associated contact and company
            foreach ($sb->getCRMScope()->lead()->batch->list(
                order: [],
                filter: ['=ID' => $arLeadDuplicate, 'STATUS_ID' => 'CONVERTED'],
                select: ['ID', 'COMPANY_ID', 'CONTACT_ID']
            ) as $lead) {
                if ($lead->COMPANY_ID > 0 && empty($arFields['COMPANY_ID'])) {
                    $arFields['COMPANY_ID'] = $lead->COMPANY_ID;
                }
                if ($lead->CONTACT_ID > 0 && empty($arFields['CONTACT_ID'])) {
                    $arFields['CONTACT_ID'] = $lead->CONTACT_ID;
                }
            }
        }
        
        try {
            $sb->getCRMScope()->lead()->add($arFields); // create repeat lead
            echo json_encode(['message' => 'Lead add']);
        } catch (\Throwable $e) {
            echo json_encode(['message' => 'Lead not added: ' . $e->getMessage()]);
        }

Continue Learning

Was the article helpful?

Add Activity to a New Lead or Deal Depending on CRM Mode

Add Contact

Add Repeat Lead

Before You StartBefore You Start

1. Create a Web Form1. Create a Web Form

2. Creating a Form Handler2. Creating a Form Handler

Retrieving Data from the FormRetrieving Data from the Form

Searching for Lead DuplicatesSearching for Lead Duplicates

Processing DuplicatesProcessing Duplicates

Adding a New LeadAdding a New Lead

Verify the ResultVerify the Result

Errors and DiagnosticsErrors and Diagnostics

Key ConsiderationsKey Considerations

Full Handler Code ExampleFull Handler Code Example

Continue LearningContinue Learning

Was the article helpful?

Before You Start

1. Create a Web Form

2. Creating a Form Handler

Retrieving Data from the Form

Searching for Lead Duplicates

Processing Duplicates

Adding a New Lead

Verify the Result

Errors and Diagnostics

Key Considerations

Full Handler Code Example

Continue Learning