метод REST scope: department

department.add

Создать подразделение

Кто может выполнять: пользователь с правами на изменение структуры

Описание

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

Параметры

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

Название подразделения

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

Поле сортировки подразделения

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

Идентификатор родительского подразделения

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

Идентификатор пользователя, который станет руководителем подразделения

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

-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
    "NAME": "Отдел изучения маглов",
    "SORT": 450,
    "UF_HEAD": 1,
    "PARENT": 15
}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/department.add

Ответ

HTTP-статус: 200

{
    "result": 18,
    "time": {
        "start": 1736927311.779587,
        "finish": 1736927312.132503,
        "duration": 0.35291600227355957,
        "processing": 0.17050600051879883,
        "date_start": "2025-01-15T07:48:31+00:00",
        "date_finish": "2025-01-15T07:48:32+00:00",
        "operating": 0.1704881191253662
    }
}

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

result integer

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

time time

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

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

HTTP-статус: 400

{
    "error": "ERROR_CORE",
    "error_description": "Не введено название раздела.\u003Cbr\u003E"
}
Код Описание Значение
ERROR_CORE Не введено название раздела.\u003Cbr\u003E Не заполнен обязательный параметр NAME
ERROR_CORE В структуре компании должен быть только один раздел верхнего уровня Неверно указан параметр PARENT
ERROR_CORE Access denied Недостаточно прав для добавления отдела

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

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