метод REST scope: humanresources

humanresources.node.add

Создать отдел

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

Описание

Метод относится к REST 3.0. Особенности вызова и формат ответа новой версии API описаны в обзоре REST 3.0.

Метод humanresources.node.add создает новый отдел или команду.

Параметры

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

Тип создаваемого элемента структуры.

Возможные значения:

  • DEPARTMENT — отдел
  • TEAM — команда
name string обязательный

Название отдела или команды

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

Идентификатор родительского отдела или команды.

Идентификатор можно получить методом humanresources.node.list

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

Описание отдела или команды

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

Цвет команды.

Возможные значения:

  • blue — синий
  • green — зеленый
  • cyan — голубой
  • orange — оранжевый
  • purple — фиолетовый
  • pink — розовый
userIds object необязательный

Пользователи, которых нужно добавить в отдел или команду. Описание структуры объекта

Идентификаторы пользователей можно получить методом user.get

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

Определяет, нужно ли переводить пользователей из userIds в новый отдел.

Возможные значения:

  • true — пользователи перестают числиться в прежнем отделе и переходят в новый отдел
  • false — пользователи только добавляются в новый отдел

По умолчанию: false

Используйте, если type равно DEPARTMENT

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

Определяет, нужно ли создать новый чат для отдела.

Возможные значения:

  • true — создать чат
  • false — не создавать чат

По умолчанию: false

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

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

Идентификаторы чатов можно получить методом im.recent.list

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

Определяет, нужно ли создать новый канал для отдела.

Возможные значения:

  • true — создать канал
  • false — не создавать канал

По умолчанию: false

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

Массив идентификаторов существующих каналов, которые нужно привязать к отделу.

Идентификаторы каналов можно получить методом im.recent.list

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

Определяет, нужно ли создать новый коллаб для отдела, если коллабы доступны в тарифе.

Возможные значения:

  • true — создать коллаб
  • false — не создавать коллаб

По умолчанию: false

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

Массив идентификаторов существующих коллабов, которые нужно привязать к отделу.

Идентификаторы коллабов можно получить методом socialnetwork.api.workgroup.list

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

Дополнительные настройки отдела или команды. Описание структуры объекта

Параметр userIds

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

Идентификаторы руководителей отдела

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

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

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

Идентификаторы сотрудников отдела

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

Идентификаторы руководителей команды

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

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

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

Идентификаторы участников команды

Параметр settings

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

Роли, которым разрешено работать с бизнес-процессами отдела или команды.

Возможные значения:

  • HEAD — руководитель отдела
  • DEPUTY_HEAD — заместитель руководителя отдела
  • ALL_DEPARTMENT_HEADS — все руководители отделов
  • EMPLOYEE — сотрудник отдела
  • TEAM_HEAD — руководитель команды
  • TEAM_DEPUTY — заместитель руководителя команды
  • TEAM_EMPLOYEE — участник команды
REPORTS_AUTHORITY array необязательный

Роли, которым разрешено работать с отчетами отдела или команды.

Возможные значения:

  • HEAD — руководитель отдела
  • DEPUTY_HEAD — заместитель руководителя отдела
  • ALL_DEPARTMENT_HEADS — все руководители отделов
  • EMPLOYEE — сотрудник отдела
  • TEAM_HEAD — руководитель команды
  • TEAM_DEPUTY — заместитель руководителя команды
  • TEAM_EMPLOYEE — участник команды

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"type":"DEPARTMENT","name":"Отдел маркетинга","parentId":1,"description":"Отвечает за продвижение","userIds":{"MEMBER_HEAD":[7],"MEMBER_EMPLOYEE":[12,15]},"moveUsersToNode":true,"createChat":true,"bindingChatIds":[31],"createChannel":false,"createCollab":false,"settings":{"BUSINESS_PROC_AUTHORITY":["HEAD","DEPUTY_HEAD"],"REPORTS_AUTHORITY":["HEAD"]}}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/humanresources.node.add

Ответ

HTTP-статус: 200

{
    "result": {
        "id": 44,
        "name": "Отдел маркетинга",
        "type": "DEPARTMENT",
        "structureId": 1,
        "parentId": 1,
        "description": "Отвечает за продвижение",
        "accessCode": "DR44",
        "userCount": 3,
        "colorName": null,
        "xmlId": null,
        "createdAt": "2026-06-02T11:15:20+03:00",
        "updatedAt": "2026-06-02T11:15:20+03:00",
        "members": [
            {
                "userId": 7,
                "name": "Анна Смирнова",
                "workPosition": "Руководитель отдела маркетинга",
                "role": "MEMBER_HEAD",
                "avatar": "https://example.bitrix24.ru/upload/main/1/avatar.jpg",
                "url": "/company/personal/user/7/"
            },
            {
                "userId": 12,
                "name": "Иван Петров",
                "workPosition": "Маркетолог",
                "role": "MEMBER_EMPLOYEE",
                "avatar": null,
                "url": "/company/personal/user/12/"
            }
        ]
    },
    "time": {
        "start": 1780388120,
        "finish": 1780388120.645321,
        "duration": 0.6453211307525635,
        "processing": 0.6032140254974365,
        "date_start": "2026-06-02T11:15:20+03:00",
        "date_finish": "2026-06-02T11:15:20+03:00",
        "operating_reset_at": 1780388720,
        "operating": 0
    }
}

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

result object

Объект с данными созданного элемента структуры

id integer

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

name string

Название отдела или команды

type string

Тип элемента структуры

structureId integer

Идентификатор структуры компании

parentId integer

Идентификатор родительского отдела или команды

description string

Описание отдела или команды

accessCode string

Код доступа элемента структуры

userCount integer

Количество пользователей в отделе или команде

colorName string

Цвет команды, если он задан

xmlId string

Внешний идентификатор элемента структуры

createdAt datetime

Дата и время создания элемента структуры

updatedAt datetime

Дата и время последнего обновления элемента структуры

members array

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

members[] object

Объект пользователя отдела или команды

userId integer

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

name string

Имя пользователя

workPosition string

Должность пользователя

role string

Роль пользователя в отделе или команде

avatar string

Ссылка на аватар пользователя

url string

Ссылка на профиль пользователя

time time

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

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

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
        "message": "Ошибка при валидации объекта запроса",
        "validation": [
            {
                "message": "Обязательное поле `name` не указано",
                "field": "name"
            }
        ]
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
type name parentId Обязательное поле #FIELD# не указано Добавьте указанное поле в тело запроса
FIELD# В поле #FIELD# требуется тип данных #TYPE# для такого запроса Убедитесь, что передаваемое значение нужного типа
type Передано недопустимое значение типа элемента структуры Используйте DEPARTMENT для отдела или TEAM для команды
Структура компании по умолчанию не найдена Проверьте, что структура компании создана и доступна

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

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