метод REST scope: lists

lists.element.add

Создать элемент универсального списка

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

Описание

Метод lists.element.add создает элемент списка.

Параметры

IBLOCK_TYPE_ID string обязательный

Идентификатор типа инфоблока.

Стандартные типы:
- lists — универсальные списки
- bitrix_processes — процессы
- lists_socnet — списки групп

В коробочной версии можно также указать идентификатор произвольного существующего типа инфоблоков. IBLOCK_ID или IBLOCK_CODE должен указывать на инфоблок этого типа. Доступ к операции определяется стандартными правами пользователя на инфоблок, раздел или элемент

IBLOCK_ID integer обязательный

Идентификатор инфоблока.

Идентификатор можно получить с помощью метода lists.get

IBLOCK_CODE string обязательный

Cимвольный код инфоблока.

Код можно получить с помощью метода lists.get

Необходимо указать хотя бы один из параметров: IBLOCK_ID или IBLOCK_CODE

ELEMENT_CODE string обязательный

Символьный код элемента

FIELDS array обязательный

Массив полей.

Подробное описание

IBLOCK_SECTION_ID integer необязательный

Идентификатор раздела, в который добавляется элемент.

Если параметр не передается, элемент создается в корне списка. Значение по умолчанию — 0.

Идентификатор можно получить с помощью метода lists.section.get

LIST_ELEMENT_URL string необязательный

Шаблон адреса к элементам списка.

Поддерживает замены: #list_id#, #section_id#, #element_id#, #group_id#

Параметр FIELDS

NAME string обязательный

Название элемента

PROPERTY_PropertyId необязательный

Пользовательские свойства.

Любое свойство элемента можно настроить как множественное. Для множественных свойств передавайте массив, даже если значение только одно.

Чтобы передать значение в поле типа Файл укажите:
- для типа Файл — base64 или массив с названием и base64
- для типа Файл (Диск) — идентификатор файла с Диска

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"IBLOCK_TYPE_ID":"lists","IBLOCK_ID":47,"ELEMENT_CODE":"test_element","LIST_ELEMENT_URL":"#list_id#/element/#section_id#/#element_id#/","FIELDS":{"NAME":"Тестовый элемент","PROPERTY_951":["1269","1271"],"PROPERTY_1003":"2024-12-31 23:59:59"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/lists.element.add

Ответ

HTTP-статус: 200

{
    "result": 6999,
    "time": {
        "start": 1763654360,
        "finish": 1763654360.814629,
        "duration": 0.814629077911377,
        "processing": 0,
        "date_start": "2025-11-19T13:59:20+03:00",
        "date_finish": "2025-11-19T13:59:20+03:00",
        "operating_reset_at": 1763654960,
        "operating": 0
    }
}

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

result integer

Идентификатор созданного элемента

time time

Информация о времени выполнения запроса

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

HTTP-статус: 400

{
    "error":"ERROR_ELEMENT_FIELD_VALUE",
    "error_description":"Writing file values by ID is not supported"
}
Код Описание Значение
ERROR_REQUIRED_PARAMETERS_MISSING Required parameter X is missing Обязательный параметр не передан
ERROR_IBLOCK_NOT_FOUND Iblock not found Инфоблок не найден
ERROR_ELEMENT_ALREADY_EXISTS Element already exists Элемент с таким CODE уже существует
ERROR_ADD_ELEMENT Ошибка при добавлении элемента
ERROR_ELEMENT_FIELD_VALUE Writing file values by ID is not supported Ошибка валидации значения поля
ACCESS_DENIED Access denied Недостаточно прав для добавления элемента

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.