Skip to main content
Это операция добавления нескольких пользователей в группу одновременно. Если пользователь уже является участником группы, он не будет добавлен повторно.
При добавлении пользователей в группу автоматически создаются связанные записи участников и доступов. Если пользователь уже является участником группы, он не будет добавлен повторно.

Заголовки запроса

string
обязательно
API-токен сервисного пользователя в формате Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете: Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».
integer
обязательно
Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.
integer
обязательно
Числовой ID школы, берётся там же, где Seller-Id. Значение должно совпадать со школой продавца — иначе вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".
Требуется аутентификация и право «Управление пользователями школы» (SchoolManageUsers).

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

Максимальное количество пользователей, которое можно добавить за один запрос — 250. Для добавления большего количества пользователей используйте несколько запросов.
integer
обязательно
ID группы — поле groupId из списка групп. Чтобы записать пользователя на курс, найдите группу этого курса фильтром courseIds (подробнее — Запись на курс). Группа должна быть привязана к продукту, иначе вернётся ошибка GroupNotBoundToProduct.
integer[]
обязательно
Массив числовых ID пользователей в Exode (поле id из user/find или user/list). Максимум 250 пользователей за один запрос.
Если пользователь уже является участником группы, он не будет добавлен повторно. В ответе будет указано, какие пользователи уже существуют в группе, а какие были добавлены. ID, не найденные в школе из заголовка School-Id, молча пропускаются и не попадают ни в exist, ни в created — сверяйте ответ с запросом. Повторный вызов с теми же userIds безопасен.
Для каждого нового участника выдаётся (или повторно активируется, если был отключён) доступ к продукту группы, и отправляется вебхук ProductEnrolledViaLms. Для пользователей из exist доступ и вебхуки не затрагиваются.

Параметры ответа

array
Массив пользователей, которые уже являются участниками группы.
array
Массив пользователей, которые были добавлены в группу. Каждый элемент имеет ту же структуру, что и элементы массива exist.
array
Массив пользователей, пропущенных из-за исключения из автоматического назначения. Элементы — объекты пользователя (та же структура, что и вложенный user в элементах exist).Для этого метода массив всегда пустой: исключения ограничивают только автоматическое назначение по правилам оргструктуры, а добавление через API считается ручным. Поле присутствует в ответе всегда — учитывайте его при строгой валидации схемы.
Ручное добавление снимает ранее выставленное исключение: если пользователя до этого убрали из группы вручную, после добавления через API правила автоматического назначения снова смогут его назначать.

Требования к правам доступа

Для добавления участников в группу требуется право «Управление пользователями школы» (SchoolManageUsers).
Сервисный пользователь должен быть аутентифицирован по токену и иметь соответствующие права доступа к указанной школе.

Обновлено: 2026-09-25 13:43 UTC