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

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

Authorization
string
required
API токен сервисного пользователя в формате Bearer. Получите токен в панели администратора школы. Формат: Bearer YOUR_TOKEN.
Seller-Id
string
required
Уникальный идентификатор продавца в системе. Используется для разграничения доступа между разными продавцами.
School-Id
string
required
Уникальный идентификатор школы в системе. Определяет контекст выполнения операции.

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

Максимальное количество пользователей, которое можно добавить за один запрос — 100. Для добавления большего количества пользователей используйте несколько запросов.
userIds
array
required
Массив идентификаторов пользователей для добавления в группу. Максимум 100 пользователей за один запрос.
Если пользователь уже является участником группы, он не будет добавлен повторно. В ответе будет указано, какие пользователи уже существуют в группе, а какие были добавлены.
curl --location --request POST 'https://api.exode.biz/saas/v2/group/{{ groupId }}/member/create-many' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "userIds": [8, 15, 23]
  }'
{
  "success": true,
  "code": 201,
  "payload": {
    "exist": [],
    "created": [
      {
        "id": 1227,
        "createdAt": "2025-07-19T15:45:51.212Z",
        "updatedAt": "2025-07-19T15:45:51.212Z",
        "deletedAt": null,
        "archivedAt": null,
        "active": true,
        "blockedUntil": null,
        "user": {
          "id": 15,
          "uuid": "YRnh3REH1Wbd",
          "active": true,
          "activated": true,
          "verified": false,
          "banned": false,
          "email": "[email protected]",
          "phone": "+987654321",
          "language": "Ru",
          "timezone": 5,
          "lastOnlineAt": "2025-07-20T19:14:03.972Z",
          "starsBalance": 0
        }
      }
    ]
  }
}

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

exist
array
Массив пользователей, которые уже являются участниками группы.
created
array
Массив пользователей, которые были добавлены в группу.

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

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