При добавлении пользователей в группу автоматически создаются связанные записи участников и доступов. Если пользователь уже
является участником группы, он не будет добавлен повторно.
Заголовки запроса
string
обязательно
API-токен сервисного пользователя в формате
Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете:
Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».integer
обязательно
Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в
карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.
integer
обязательно
Числовой ID школы, берётся там же, где
Seller-Id. Значение должно совпадать со школой продавца — иначе
вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".SchoolManageUsers).
Параметры запроса
integer
обязательно
ID группы — поле
groupId из списка групп. Чтобы записать пользователя на
курс, найдите группу этого курса фильтром courseIds (подробнее — Запись на курс).
Группа должна быть привязана к продукту, иначе вернётся ошибка GroupNotBoundToProduct.integer[]
обязательно
Если пользователь уже является участником группы, он не будет добавлен повторно. В ответе будет указано, какие
пользователи уже существуют в группе, а какие были добавлены. ID, не найденные в школе из заголовка
School-Id,
молча пропускаются и не попадают ни в exist, ни в created — сверяйте ответ с запросом. Повторный вызов с
теми же userIds безопасен.Для каждого нового участника выдаётся (или повторно активируется, если был отключён) доступ к продукту группы,
и отправляется вебхук
ProductEnrolledViaLms. Для пользователей из exist
доступ и вебхуки не затрагиваются.Параметры ответа
array
Массив пользователей, которые уже являются участниками группы.
array
Массив пользователей, которые были добавлены в группу. Каждый элемент имеет ту же структуру, что и элементы
массива
exist.array
Массив пользователей, пропущенных из-за исключения из автоматического назначения. Элементы — объекты
пользователя (та же структура, что и вложенный
user в элементах exist).Для этого метода массив всегда пустой: исключения ограничивают только автоматическое назначение по
правилам оргструктуры, а добавление через API считается ручным. Поле присутствует в ответе всегда — учитывайте
его при строгой валидации схемы.Ручное добавление снимает ранее выставленное исключение: если пользователя до этого убрали из группы
вручную, после добавления через API правила автоматического назначения снова смогут его назначать.
Требования к правам доступа
Для добавления участников в группу требуется право «Управление пользователями школы» (
SchoolManageUsers).Обновлено: 2026-09-25 13:43 UTC