How to Change or Delete Phone Numbers and Emails

# pip install b24pysdk
        from b24pysdk import BitrixWebhook, Client
        
        client = Client(
            BitrixWebhook(
                domain="your-domain.bitrix24.com",
                webhook_token="USER_ID/TOKEN",  # user_id/token only, without https://
            )
        )
        
        item = client.crm.item.add(
            3,  # 3 — contact
            {
                "name": "Klaus",
                "lastName": "Weber",
                "fm": [
                    {"typeId": "EMAIL", "valueType": "WORK", "value": "work_email@nomail.com"},
                    {"typeId": "EMAIL", "valueType": "HOME", "value": "home_email@nomail.com"},
                    {"typeId": "PHONE", "valueType": "WORK", "value": "+493012345678"},
                    {"typeId": "PHONE", "valueType": "MOBILE", "value": "+493076543210"},
                ],
            },
        ).response.result["item"]
        
        contact_id = item["id"]
        

<?php
        // composer require bitrix24/b24phpsdk:"^3.0"
        require_once 'vendor/autoload.php';
        
        use Bitrix24\SDK\Services\ServiceBuilderFactory;
        use Symfony\Component\EventDispatcher\EventDispatcher;
        use Psr\Log\NullLogger;
        
        $sb = (new ServiceBuilderFactory(new EventDispatcher(), new NullLogger()))
            ->initFromWebhook('https://your-domain.bitrix24.com/rest/USER_ID/TOKEN/');
        
        $resultAdd = $sb->getCRMScope()->item()->add(
            3, // 3 — contact
            [
                'name' => 'Klaus',
                'lastName' => 'Weber',
                'fm' => [
                    [ 'typeId' => 'EMAIL', 'valueType' => 'WORK', 'value' => 'work_email@nomail.com' ],
                    [ 'typeId' => 'EMAIL', 'valueType' => 'HOME', 'value' => 'home_email@nomail.com' ],
                    [ 'typeId' => 'PHONE', 'valueType' => 'WORK', 'value' => '+493012345678' ],
                    [ 'typeId' => 'PHONE', 'valueType' => 'MOBILE', 'value' => '+493076543210' ]
                ]
            ]
        );
        
        $contactId = $resultAdd->item()->id;
        

multifields = client.crm.item.get(
            3,
            contact_id,
        ).response.result["item"]["fm"]
        

$multifields = $sb->getCRMScope()->item()->get(3, $contactId)->item()->fm;
        

result_update = client.crm.item.update(
            3,
            contact_id,
            {
                "fm": {
                    # the key is the entry id from step 2
                    "8553": {"typeId": "EMAIL", "valueType": "WORK", "value": "new_work_email@nomail.com"},  # change the work email
                    "8555": {"typeId": "EMAIL", "value": ""},  # an empty value deletes the personal email
                    "8559": {"typeId": "PHONE", "valueType": "MOBILE", "value": "+493055544433"},  # change the mobile phone
                },
            },
        ).response.result["item"]
        

$resultUpdate = $sb->getCRMScope()->item()->update(
            3,
            $contactId,
            [
                'fm' => [
                    // the key is the entry id from step 2
                    8553 => [ 'typeId' => 'EMAIL', 'valueType' => 'WORK', 'value' => 'new_work_email@nomail.com' ], // change the work email
                    8555 => [ 'typeId' => 'EMAIL', 'value' => '' ], // an empty value deletes the personal email
                    8559 => [ 'typeId' => 'PHONE', 'valueType' => 'MOBILE', 'value' => '+493055544433' ] // change the mobile phone
                ]
            ]
        );
        

print(client.crm.item.get(3, contact_id).response.result["item"]["fm"])
        

print_r($sb->getCRMScope()->item()->get(3, $contactId)->item()->fm);
        

# pip install b24pysdk
        from b24pysdk import BitrixWebhook, Client
        from b24pysdk.errors import BitrixAPIError
        
        client = Client(
            BitrixWebhook(
                domain="your-domain.bitrix24.com",
                webhook_token="USER_ID/TOKEN",  # user_id/token only, without https://
            )
        )
        
        ENTITY_TYPE_ID = 3  # 3 — contact, company — 4, lead — 1
        
        
        def find_id(multifields, type_id, value_type):
            """Finds the id of a multifield entry by its type and value subtype."""
            for field in multifields:
                if field["typeId"] == type_id and field["valueType"] == value_type:
                    return field["id"]
            return None
        
        
        try:
            # Step 1: create a contact with an email and phone numbers
            created = client.crm.item.add(
                ENTITY_TYPE_ID,
                {
                    "name": "Klaus",
                    "lastName": "Weber",
                    "fm": [
                        {"typeId": "EMAIL", "valueType": "WORK", "value": "work_email@nomail.com"},
                        {"typeId": "EMAIL", "valueType": "HOME", "value": "home_email@nomail.com"},
                        {"typeId": "PHONE", "valueType": "WORK", "value": "+493012345678"},
                        {"typeId": "PHONE", "valueType": "MOBILE", "value": "+493076543210"},
                    ],
                },
            ).response.result["item"]
            contact_id = created["id"]
            print(f"Contact created, id: {contact_id}")
        
            # Step 2: read the identifiers of the multifield entries
            multifields = client.crm.item.get(
                ENTITY_TYPE_ID,
                contact_id,
            ).response.result["item"]["fm"]
        
            work_email_id = find_id(multifields, "EMAIL", "WORK")
            home_email_id = find_id(multifields, "EMAIL", "HOME")
            mobile_phone_id = find_id(multifields, "PHONE", "MOBILE")
        
            if not all((work_email_id, home_email_id, mobile_phone_id)):
                print("The contact does not have the required multifield entries")
            else:
                # Step 3: change some values and delete others
                # typeId is required in every element, otherwise the operation is silently skipped
                updated = client.crm.item.update(
                    ENTITY_TYPE_ID,
                    contact_id,
                    {
                        "fm": {
                            str(work_email_id): {"typeId": "EMAIL", "valueType": "WORK", "value": "new_work_email@nomail.com"},
                            str(home_email_id): {"typeId": "EMAIL", "value": ""},
                            str(mobile_phone_id): {"typeId": "PHONE", "valueType": "MOBILE", "value": "+493055544433"},
                        },
                    },
                ).response.result["item"]
        
                print("Contact details updated:")
                print(updated["fm"])
        except BitrixAPIError as error:
            print(f"Contact details not updated: {error}")
        

<?php
        // composer require bitrix24/b24phpsdk:"^3.0"
        require_once 'vendor/autoload.php';
        
        use Bitrix24\SDK\Services\ServiceBuilderFactory;
        use Symfony\Component\EventDispatcher\EventDispatcher;
        use Psr\Log\NullLogger;
        
        $sb = (new ServiceBuilderFactory(new EventDispatcher(), new NullLogger()))
            ->initFromWebhook('https://your-domain.bitrix24.com/rest/USER_ID/TOKEN/');
        
        $entityTypeId = 3; // 3 — contact, company — 4, lead — 1
        $item = $sb->getCRMScope()->item();
        
        // finds the id of a multifield entry by its type and value subtype
        $findId = static function (array $multifields, string $typeId, string $valueType) {
            foreach ($multifields as $field) {
                if ($field['typeId'] === $typeId && $field['valueType'] === $valueType) {
                    return $field['id'];
                }
            }
            return null;
        };
        
        try {
            // Step 1: create a contact with an email and phone numbers
            $contactId = $item->add(
                $entityTypeId,
                [
                    'name' => 'Klaus',
                    'lastName' => 'Weber',
                    'fm' => [
                        [ 'typeId' => 'EMAIL', 'valueType' => 'WORK', 'value' => 'work_email@nomail.com' ],
                        [ 'typeId' => 'EMAIL', 'valueType' => 'HOME', 'value' => 'home_email@nomail.com' ],
                        [ 'typeId' => 'PHONE', 'valueType' => 'WORK', 'value' => '+493012345678' ],
                        [ 'typeId' => 'PHONE', 'valueType' => 'MOBILE', 'value' => '+493076543210' ]
                    ]
                ]
            )->item()->id;
            echo 'Contact created, id: ' . $contactId . PHP_EOL;
        
            // Step 2: read the identifiers of the multifield entries
            $multifields = $item->get($entityTypeId, $contactId)->item()->fm;
        
            $workEmailId = $findId($multifields, 'EMAIL', 'WORK');
            $homeEmailId = $findId($multifields, 'EMAIL', 'HOME');
            $mobilePhoneId = $findId($multifields, 'PHONE', 'MOBILE');
            if ($workEmailId === null || $homeEmailId === null || $mobilePhoneId === null) {
                echo 'The contact does not have the required multifield entries';
                return;
            }
        
            // Step 3: change some values and delete others
            // typeId is required in every element, otherwise the operation is silently skipped
            $updated = $item->update(
                $entityTypeId,
                $contactId,
                [
                    'fm' => [
                        $workEmailId => [ 'typeId' => 'EMAIL', 'valueType' => 'WORK', 'value' => 'new_work_email@nomail.com' ],
                        $homeEmailId => [ 'typeId' => 'EMAIL', 'value' => '' ],
                        $mobilePhoneId => [ 'typeId' => 'PHONE', 'valueType' => 'MOBILE', 'value' => '+493055544433' ]
                    ]
                ]
            );
        
            echo 'Contact details updated:' . PHP_EOL;
            print_r($updated->item()->fm);
        } catch (\Throwable $e) {
            echo 'Contact details not updated: ' . $e->getMessage();
        }