Изменить контакт crm.contact.update

Если вы разрабатываете интеграции для Битрикс24 с помощью AI-инструментов (Codex, Claude Code, Cursor), подключите MCP-сервер, чтобы ассистент использовал официальную REST-документацию.

Scope: crm

Кто может выполнять метод: любой пользователь с правом «изменения» контактов

DEPRECATED

Развитие метода остановлено. Используйте crm.item.update.

Метод crm.contact.update обновляет существующий контакт.

Рекомендуем при обновлении адреса передавать полный набор полей адреса в метод обновления.

Параметры метода

Обязательные параметры отмечены *

Название `тип`	Описание
id* `integer`	Идентификатор контакта, который нужно изменить. Идентификатор можно получить методами `crm.сontact.list` или `crm.contact.add`
fields* `object`	Объект формата: `{ field_1: value_1, field_2: value_2, ..., field_n: value_n, }` где: `field_n` — название поля `value_n` — новое значение поля Список доступных полей описан ниже. Некорректное поле в `fields` будет проигнорировано. В `fields` нужно передавать только те поля, которые нужно изменить
params `object`	Объект, содержащий набор дополнительных параметров. Структура и возможные значения описаны ниже

Параметр fields

Название `тип`	Описание
HONORIFIC `crm_status`	Обращение. Список доступных типов обращений можно узнать с помощью `crm.status.list`, применив фильтр `{ ENTITY_ID: "HONORIFIC" }`
NAME `string`	Имя
SECOND_NAME `string`	Отчество
LAST_NAME `string`	Фамилия
PHOTO `file`	Фотография
BIRTHDATE `date`	Дата рождения
TYPE_ID `crm_status`	Тип контакта. Список доступных типов контакта можно узнать с помощью `crm.status.list`, применив фильтр `{ ENTITY_ID: "CONTACT_TYPE" }`
SOURCE_ID `crm_status`	Источник Список доступных типов источника можно узнать с помощью `crm.status.list`, применив фильтр `{ ENTITY_ID: "SOURCE" }`
SOURCE_DESCRIPTION `string`	Дополнительно об источнике
POST `string`	Должность
COMMENTS `string`	Комментарий. Поддерживает bb-коды
OPENED `boolean`	Доступен ли для всех. Возможные значения: `Y` — да `N` — нет
EXPORT `boolean`	Участвует ли контакт в экспорте. Возможные значения: `Y` — да `N` — нет
ASSIGNED_BY_ID `user`	Идентификатор пользователя, ответственного за элемент
COMPANY_ID `crm_company`	Идентификатор основной компании для контакта. Список компаний можно получить с помощью метода `crm.item.list` по `entityTypeId = 4`
COMPANY_IDS `crm_company[]`	Массив идентификаторов компаний, к которым привязан контакт. Список компаний можно получить с помощью метода `crm.item.list` по `entityTypeId = 4`
UTM_SOURCE `string`	Рекламная система (Yandex-Direct, Google-Adwords и другие)
UTM_MEDIUM `string`	Тип трафика. Возможные значения: `CPC` — объявления `CPM` — баннеры
UTM_CAMPAIGN `string`	Обозначение рекламной кампании
UTM_CONTENT `string`	Содержание кампании. Например, для контекстных объявлений
UTM_TERM `string`	Условие поиска кампании. Например, ключевые слова контекстной рекламы
PHONE `crm_multifield[]`	Телефон
EMAIL `crm_multifield[]`	E-mail
WEB `crm_multifield[]`	Сайт
IM `crm_multifield[]`	Мессенджер
LINK `crm_multifield[]`	Ссылки. Служебное поле
UF_...	Пользовательские поля. Например, `UF_CRM_25534736`. В зависимости от настроек портала у контактов может быть набор пользовательских полей определенных типов. Для изменения файловых полей рекомендуется использовать метод crm.item.update. Добавить пользовательское поле в контакт можно с помощью метода crm.contact.userfield.add
PARENT_ID_...	Поля связей. Если на портале есть смарт-процессы, связанные с контактами, для каждого такого смарт-процесса существует поле, хранящее связь между этим смарт-процессом и контактом. Само поле хранит идентификатор элемента такого смарт-процесса. Например, поле `PARENT_ID_153` — связь со смарт-процессом `entityTypeId=153`. Оно хранит идентификатор элемента этого смарт-процесса, связанного с текущим контактом

Поля связи с внешними источниками данных

Если контакт создан внешней системой, то:

поле ORIGINATOR_ID хранит строковый идентификатор этой системы
поле ORIGIN_ID хранит строковый идентификатор контакта в этой внешней системе
поле ORIGIN_VERSION хранит версию данных контакта в этой внешней системе

Название `тип`	Описание
ORIGINATOR_ID `string`	Идентификатор внешней системы, являющейся источником данных об этом контакте
ORIGIN_ID `string`	Версия данных о контакте во внешней системе. Используется для защиты данных от случайного перетирания внешней системой. Если данные были импортированы и не изменялись во внешней системе, то такие данные могут быть редактированы в CRM без опасения, что следующая выгрузка приведет к перетиранию данных
ORIGIN_VERSION `string`	Версия оригинала

Устаревшие поля

Поля адреса в контакте являются устаревшими и используются только в режиме совместимости. Для работы с адресом используйте реквизиты.

Название `тип`	Описание
ADDRESS `string`	Адрес
ADDRESS_2 `string`	Вторая строка адреса
ADDRESS_CITY `string`	Город
ADDRESS_POSTAL_CODE `string`	Почтовый индекс
ADDRESS_REGION `string`	Район
ADDRESS_PROVINCE `string`	Область
ADDRESS_COUNTRY `string`	Страна
ADDRESS_COUNTRY_CODE `string`	Код страны
ADDRESS_LOC_ADDR_ID `integer`	Идентификатор адреса местоположения

Параметр params

Название
тип

Описание

REGISTER_SONET_EVENT
boolean

Производить ли регистрацию события обновления контакта в живой ленте. Возможные значения:

Y — да
N — нет

По умолчанию N

REGISTER_HISTORY_EVENT
boolean

Производить ли регистрацию обновления контакта в истории. Возможные значения:

Y — да
N — нет

По умолчанию Y

Примеры кода

Как использовать примеры в документации

Изменить контакт c id = 43

cURL (Webhook)

cURL (OAuth)

PHP

BX24.js

PHP CRest

curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"ID":43,"FIELDS":{"NAME":"Сергей","BIRTHDATE":"11.11.1999","TYPE_ID":"RECOMMENDATION","SOURCE_ID":"WEB","POST":"Администратор компьютерных сетей","COMMENTS":"Новый комментарий","OPENED":"N","EXPORT":"Y","ASSIGNED_BY_ID":1,"COMPANY_ID":12,"COMPANY_IDS":[13,15],"UF_CRM_1720697698689":"Пример нового значения пользовательского поля с типом \"Строка\"","PARENT_ID_1224":14},"PARAMS":{"REGISTER_SONET_EVENT":"N","REGISTER_HISTORY_EVENT":"N"}}' \
        https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.contact.update

curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"ID":43,"FIELDS":{"NAME":"Сергей","BIRTHDATE":"11.11.1999","TYPE_ID":"RECOMMENDATION","SOURCE_ID":"WEB","POST":"Администратор компьютерных сетей","COMMENTS":"Новый комментарий","OPENED":"N","EXPORT":"Y","ASSIGNED_BY_ID":1,"COMPANY_ID":12,"COMPANY_IDS":[13,15],"UF_CRM_1720697698689":"Пример нового значения пользовательского поля с типом \"Строка\"","PARENT_ID_1224":14},"PARAMS":{"REGISTER_SONET_EVENT":"N","REGISTER_HISTORY_EVENT":"N"},"auth":"**put_access_token_here**"}' \
        https://**put_your_bitrix24_address**/rest/crm.contact.update

try
        {
        	const response = await $b24.callMethod(
        		'crm.contact.update',
        		{
        			id: 43,
        			fields: {
        				NAME: "Сергей",
        				BIRTHDATE: '11.11.1999',
        				TYPE_ID: "RECOMMENDATION",
        				SOURCE_ID: "WEB",
        				POST: "Администратор компьютерных сетей",
        				COMMENTS: "Новый комментарий",
        				OPENED: "N",
        				EXPORT: "Y",
        				ASSIGNED_BY_ID: 1,
        				COMPANY_ID: 12,
        				COMPANY_IDS: [13, 15],
        				UF_CRM_1720697698689: "Пример нового значения пользовательского поля с типом \"Строка\"",
        				PARENT_ID_1224: 14,
        			},
        			params: {
        				REGISTER_SONET_EVENT: "N",
        				REGISTER_HISTORY_EVENT: "N",
        			},
        		}
        	);
        	
        	const result = response.getData().result;
        	result.error()
        		? console.error(result.error())
        		: console.info(result)
        	;
        }
        catch( error )
        {
        	console.error('Error:', error);
        }

try {
            $contactId = 123; // Example contact ID
            $fields = [
                'NAME' => 'John',
                'LAST_NAME' => 'Doe',
                'BIRTHDATE' => (new DateTime('1990-01-01'))->format(DateTime::ATOM),
                'PHONE' => '123456789',
                'EMAIL' => 'john.doe@example.com',
                'ADDRESS' => '123 Main St',
                'ADDRESS_CITY' => 'Anytown',
                'ADDRESS_COUNTRY' => 'USA',
            ];
            $params = [
                'REGISTER_SONET_EVENT' => 'Y',
            ];
            $result = $serviceBuilder
                ->getCRMScope()
                ->contact()
                ->update($contactId, $fields, $params);
            if ($result->isSuccess()) {
                print($result->getCoreResponse()->getResponseData()->getResult()[0]);
            } else {
                print('Update failed.');
            }
        } catch (Throwable $e) {
            print('Error: ' . $e->getMessage());
        }

BX24.callMethod(
            'crm.contact.update',
            {
                id: 43,
                fields: {
                    NAME: "Сергей",
                    BIRTHDATE: '11.11.1999',
                    TYPE_ID: "RECOMMENDATION",
                    SOURCE_ID: "WEB",
                    POST: "Администратор компьютерных сетей",
                    COMMENTS: "Новый комментарий",
                    OPENED: "N",
                    EXPORT: "Y",
                    ASSIGNED_BY_ID: 1,
                    COMPANY_ID: 12,
                    COMPANY_IDS: [13, 15],
                    UF_CRM_1720697698689: "Пример нового значения пользовательского поля с типом \"Строка\"",
                    PARENT_ID_1224: 14,
                },
                params: {
                    REGISTER_SONET_EVENT: "N",
                    REGISTER_HISTORY_EVENT: "N",
                },
            },
            (result) => {
                result.error()
                    ? console.error(result.error())
                    : console.info(result.data())
                ;
            },
        );

require_once('crest.php');
        
        $result = CRest::call(
            'crm.contact.update',
            [
                'ID' => 43,
                'FIELDS' => [
                    'NAME' => 'Сергей',
                    'BIRTHDATE' => '11.11.1999',
                    'TYPE_ID' => 'RECOMMENDATION',
                    'SOURCE_ID' => 'WEB',
                    'POST' => 'Администратор компьютерных сетей',
                    'COMMENTS' => 'Новый комментарий',
                    'OPENED' => 'N',
                    'EXPORT' => 'Y',
                    'ASSIGNED_BY_ID' => 1,
                    'COMPANY_ID' => 12,
                    'COMPANY_IDS' => [13, 15],
                    'UF_CRM_1720697698689' => 'Пример нового значения пользовательского поля с типом "Строка"',
                    'PARENT_ID_1224' => 14,
                ],
                'PARAMS' => [
                    'REGISTER_SONET_EVENT' => 'N',
                    'REGISTER_HISTORY_EVENT' => 'N',
                ]
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

Работа с множественными полями

Изменить множественное поле

Для перезаписи существующего значения множественного поля передайте ID поля, которое вы хотите изменить, и его новое значение/тип.

Пусть есть следующие значение поля PHONE:

[
            {
                "ID": "222",
                "VALUE_TYPE": "WORK",
                "VALUE": "111111",
                "TYPE_ID": "PHONE"
            },
            {
                "ID": "223",
                "VALUE_TYPE": "WORK",
                "VALUE": "222222",
                "TYPE_ID": "PHONE"
            },
            {
                "ID": "224",
                "VALUE_TYPE": "WORK",
                "VALUE": "333333",
                "TYPE_ID": "PHONE"
            }
        ]

Чтобы изменить значения у телефона с ID = 223, передайте следующий параметр fields:

{
            "fields": {
                "PHONE": [
                    {
                        "ID": 223,
                        "VALUE": "444444",
                        "VALUE_TYPE": "MOBILE"
                    }
                ]
            }
        }

Удалить отдельное значение множественного поля

Чтобы удалить одно из значений множественного поля, передайте их идентификаторы и либо параметр DELETE = 'Y', либо пустой VALUE.

Пусть есть следующие значение поля PHONE:

[
            {
                "ID": "222",
                "VALUE_TYPE": "WORK",
                "VALUE": "111111",
                "TYPE_ID": "PHONE"
            },
            {
                "ID": "223",
                "VALUE_TYPE": "WORK",
                "VALUE": "222222",
                "TYPE_ID": "PHONE"
            },
            {
                "ID": "224",
                "VALUE_TYPE": "WORK",
                "VALUE": "333333",
                "TYPE_ID": "PHONE"
            },
            {
              "ID": "225",
              "VALUE_TYPE": "WORK",
              "VALUE": "44444",
              "TYPE_ID": "PHONE"
            }
        ]

Рассмотрим способы удаления всех значений кроме телефона с ID = 225:

{
            "fields": {
                "PHONE": [
                    {
                        "ID": 222,
                        "DELETE": "Y"
                    },
                    {
                        "ID": 223,
                        "VALUE": ""
                    },
                    {
                        "ID": 224
                    }
                ]
            }
        }

В результате останется:

[
            {
                "ID": "225",
                "VALUE_TYPE": "WORK",
                "VALUE": "44444",
                "TYPE_ID": "PHONE"
            }
        ]

Добавить новое значение для множественного поля

Чтобы добавить новое значение, достаточно его ввести. Уже существующие значения при этом изменены не будут.

Пример добавления нового значения 55555:

{
            "fields": {
                "PHONE": [
                    {
                        "VALUE": "55555",
                        "VALUE_TYPE": "WORK"
                    }
                ]
            }
        }

Обработка ответа

HTTP-статус: 200

{
            "result": true,
            "time": {
                "start": 1723820393.459406,
                "finish": 1723820396.129949,
                "duration": 2.6705431938171387,
                "processing": 2.1193439960479736,
                "date_start": "2024-08-16T16:59:53+02:00",
                "date_finish": "2024-08-16T16:59:56+02:00"
            }
        }

Возвращаемые данные

Название `тип`	Описание
result `boolean`	Корневой элемент ответа, `true` в случае успеха
time `time`	Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
            "error": "",
            "error_description": "Contact is not found"
        }

Название `тип`	Описание
error `string`	Строковый код ошибки. Может состоять из цифр, латинских букв и знака подчеркивания
error_description `error_description`	Текстовое описание ошибки. Описание не предназначено для показа конечному пользователю в необработанном виде

Возможные коды ошибок

Код	Описание	Значение
`-`	`Parameter 'fields' must be array`	В параметр `fields` передан не объект
`-`	`Parameter 'params' must be array`	В параметр `params` передан не объект
`-`	`Access denied`	У пользователя нет прав на «Изменение» контактов
`-`	Исчерпан выделенный дисковый ресурс
`ERROR_CORE`	Поле `Рабочий e-mail` содержит некорректный адрес

Статусы и коды системных ошибок

HTTP-статус: 20x, 40x, 50x

Описанные ниже ошибки могут возникнуть при вызове любого метода

Статус	Код Текст ошибки	Описание
`500`	`INTERNAL_SERVER_ERROR` Internal server error	Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`500`	`ERROR_UNEXPECTED_ANSWER` Server returned an unexpected response	Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`503`	`QUERY_LIMIT_EXCEEDED` Too many requests	Превышен лимит на интенсивность запросов
`405`	`ERROR_BATCH_METHOD_NOT_ALLOWED` Method is not allowed for batch usage	Текущий метод не разрешен для вызова с помощью batch
`400`	`ERROR_BATCH_LENGTH_EXCEEDED` Max batch length exceeded	Превышена максимальная длина параметров, переданных в метод batch
`401`	`NO_AUTH_FOUND` Wrong authorization data	Неверный access-токен или код вебхука
`400`	`INVALID_REQUEST` Https required	Для вызовов методов требуется использовать протокол HTTPS
`503`	`OVERLOAD_LIMIT` REST API is blocked due to overload	REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка, для снятия необходимо обращаться в техническую поддержку Битрикс24
`403`	`ACCESS_DENIED` REST API is available only on commercial plans	REST API доступен только на коммерческих планах
`403`	`INVALID_CREDENTIALS` Invalid request credentials	У пользователя, с чьим access-токеном или вебхуком был вызван метод, не хватает прав
`404`	`ERROR_MANIFEST_IS_NOT_AVAILABLE` Manifest is not available	Манифест недоступен
`403`	`insufficient_scope` The request requires higher privileges than provided by the webhook token	Запрос требует более высоких привилегий, чем предоставляет токен вебхука
`401`	`expired_token` The access token provided has expired	Предоставленный access-токен доступа истек
`403`	`user_access_error` The user does not have access to the application	Пользователь не имеет доступа к приложению. Это означает, что приложение установлено, но администратор портала разрешил доступ к этому приложению только конкретным пользователям
`500`	`PORTAL_DELETED` Portal was deleted	Публичная часть сайта закрыта. Чтобы открыть публичную часть сайта на коробочной установке отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта

Продолжите изучение

Создать новый контакт

Получить контакт по Id

Изменить контакт crm.contact.update

Параметры методаПараметры метода

Параметр fieldsПараметр fields

Параметр paramsПараметр params

Примеры кодаПримеры кода

Работа с множественными полямиРабота с множественными полями

Изменить множественное полеИзменить множественное поле

Удалить отдельное значение множественного поляУдалить отдельное значение множественного поля

Добавить новое значение для множественного поляДобавить новое значение для множественного поля

Обработка ответаОбработка ответа

Возвращаемые данныеВозвращаемые данные

Обработка ошибокОбработка ошибок

Возможные коды ошибокВозможные коды ошибок

Статусы и коды системных ошибокСтатусы и коды системных ошибок

Продолжите изучениеПродолжите изучение