метод REST scope: entity

entity.item.add

Добавить элемент в хранилище

Кто может выполнять: пользователь с уровнем права W (запись) или X (управление) на хранилище данных

Описание

Метод entity.item.add добавляет элемент в хранилище данных приложения.

Метод работает только в контексте приложения.

Параметры

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

Идентификатор хранилища данных приложения. Используйте значение, которое указали при создании хранилища.

Получить идентификатор можно методом entity.get

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

Название элемента хранилища

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

Значения свойств элемента в формате {"КОД_СВОЙСТВА": значение}.

Обрабатываются только свойства, существующие в хранилище. Список доступных кодов свойств можно получить методом entity.item.property.get

Для свойств типа файл используется формат из статьи Как загрузить файлы

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

Идентификатор раздела хранилища

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

Дата начала активности элемента

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

Дата окончания активности элемента

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

Картинка анонса элемента. Формат файла — в статье Как загрузить файлы

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

Детальная картинка элемента. Формат файла — в статье Как загрузить файлы

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

Пользовательские поля элемента UF_*.

Передаются отдельными параметрами в формате "UF_КОД": значение, например: "UF_CRM_1_COLOR": "red", "UF_CRM_1_SIZE": 42

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"ENTITY":"dish","NAME":"Hello, world!","PROPERTY_VALUES":{"test":11,"test1":22},"SECTION":219,"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/entity.item.add

Ответ

HTTP-статус: 200

{
    "result": 2333,
    "time": {
        "start": 1774435185,
        "finish": 1774435185.636041,
        "duration": 0.6360409259796143,
        "processing": 0,
        "date_start": "2026-03-25T13:39:45+03:00",
        "date_finish": "2026-03-25T13:39:45+03:00",
        "operating_reset_at": 1774435785,
        "operating": 0
    }
}

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

result integer

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

time time

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

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

HTTP-статус: 400

{
    "error": "ERROR_ENTITY_NOT_FOUND",
    "error_description": "Entity not found"
}
Код Описание Значение
ERROR_ARGUMENT Argument 'ENTITY' is null or empty Параметр ENTITY не передан или пустой после очистки
ERROR_ARGUMENT Entity code is too long. Max length is N characters. Слишком длинное значение ENTITY
ERROR_ARGUMENT Ошибки валидатора полей элемента Переданы невалидные входные поля
ERROR_ENTITY_NOT_FOUND Entity not found Хранилище с переданным ENTITY не найдено
ACCESS_DENIED Access denied! Недостаточно прав для добавления элемента
ACCESS_DENIED Access denied! Application context required Нет контекста приложения (clientId)
ERROR_CORE Internal error adding entity item. Try adding again. Внутренняя ошибка при добавлении элемента

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

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