метод REST scope: sonet

sonet_group.create

Создать группу или проект

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

Описание

Метод sonet_group.create создает рабочую группу или проект.

Параметры

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

Название группы или проекта

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

Описание группы или проекта

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

Видимость группы в списке.

Возможные значения:
- Y — группа видна в общем списке
- N — группа скрыта из общего списка

По умолчанию — Y. Для экстранет-пользователя значение принудительно устанавливается в N

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

Открыта ли группа для свободного вступления.

Возможные значения:
- Y — пользователь может вступить в группу без подтверждения
- N — вступление по приглашению или запросу

По умолчанию — N. Для экстранет-пользователя значение принудительно устанавливается в N

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

Архивная ли группа.

Возможные значения:
- Y — группа в архиве
- N — активная группа

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

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

Ключевые слова через запятую

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

Кто может приглашать участников.

Возможные значения:
- A — только владелец группы
- E — владелец и модераторы
- K — все участники

Если параметр не передан, используется значение по умолчанию:
- для интранет-пользователя — K
- для экстранет-пользователя — E

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

Создать проект вместо группы.

Возможные значения:
- Y — создать проект
- N — создать группу

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

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

Дата начала проекта в формате ISO-8601

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

Дата окончания проекта в формате ISO-8601

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

Идентификатор скрам-мастера, если проект создается как скрам.

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

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

Идентификатор владельца.

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

Указание владельца доступно только администраторам. Для всех остальных владельцем автоматически становится текущий пользователь

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

Аватар группы в формате Base64

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

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

Идентификатор файла можно получить методами disk.storage.getchildren и disk.folder.getchildren.

Если одновременно передать и IMAGE_FILE_ID, и IMAGE, приоритет отдается IMAGE_FILE_ID

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

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

По умолчанию — текущий сайт

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

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

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"NAME":"Новый проект","PROJECT":"Y","VISIBLE":"Y","OPENED":"N","INITIATE_PERMS":"K","IMAGE":["avatar.png","iVBORw0KGgoAAAANSUhEUgAA..."]}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sonet_group.create

Ответ

HTTP-статус: 200

{
    "result": 77,
    "time": {
        "start": 1773921687,
        "finish": 1773921688.071989,
        "duration": 1.0719890594482422,
        "processing": 1,
        "date_start": "2026-03-19T15:01:27+03:00",
        "date_finish": "2026-03-19T15:01:28+03:00",
        "operating_reset_at": 1773922287,
        "operating": 0.9421911239624023
    }
}

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

result integer

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

time time

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

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

HTTP-статус: 400

{
    "error": "",
    "error_description": "Cannot create group"
}
Код Описание Значение
Incorrect input data Передан некорректный формат параметров
You have no permissions to create a group Недостаточно прав для создания группы или проекта
Cannot create group Не удалось создать группу или проект
ERROR_IMAGE_ID Изображение не корректно: Неверный тип файла Передан некорректный IMAGE

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

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