Для AI-агентов: markdown этой страницы — /docs-content/workgroups/members/invite.md индекс документации — /llms.txt

Пригласить участников

POST /v1/workgroups/:groupId/invitations

Отправляет пользователям приглашение вступить в рабочую группу. Участниками они становятся, только когда сами примут приглашение в Битрикс24.

Параметры

Параметр	Тип	Обяз.	Описание
`groupId` (path)	number	да	Идентификатор рабочей группы — положительное целое число. Список: `GET /v1/workgroups`

Поля запроса (body)

Поле	Тип	Обяз.	Описание
`userIds`	number[]	да	Непустой массив идентификаторов приглашаемых пользователей — положительных целых чисел. Список: `GET /v1/users`
`message`	string	нет	Текст приглашения, который увидит пользователь

Примеры

curl — личный ключ

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/workgroups/157/invitations" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"userIds": [93], "message": "Присоединяйтесь к группе проекта"}'

curl — OAuth-приложение

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/workgroups/157/invitations" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"userIds": [93], "message": "Присоединяйтесь к группе проекта"}'

JavaScript — личный ключ

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/workgroups/157/invitations', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ userIds: [93], message: 'Присоединяйтесь к группе проекта' }),
})

const body = await res.json()
if (!body.success && body.error.code === 'BITRIX_ERROR') {
  if (Array.isArray(body.error.processedUserIds)) {
    // Приглашения из processedUserIds уже отправлены — не повторяйте их
    console.log('Приглашены:', body.error.processedUserIds)
    console.log('Не приглашены:', body.error.skippedUserIds)
  } else {
    // Второй вариант 422: Битрикс24 отказал в вызове, массивов в ответе нет
    console.log('Битрикс24 отказал:', body.error.message)
  }
}

JavaScript — OAuth-приложение

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/workgroups/157/invitations', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ userIds: [93], message: 'Присоединяйтесь к группе проекта' }),
})

const body = await res.json()

Поля ответа

Поле	Тип	Описание
`success`	boolean	`true`, когда приглашения отправлены всем запрошенным пользователям
`data.groupId`	number	Идентификатор рабочей группы
`data.processedUserIds`	number[]	Идентификаторы пользователей, которым отправлено приглашение. Повторы из `userIds` схлопываются в один
`data.skippedUserIds`	number[]	В успешном ответе всегда пустой массив. Если пригласить удалось не всех, приходит `422 BITRIX_ERROR`, а оба массива переезжают в `error`. Это единственный ответ с массивами: у второго `422 BITRIX_ERROR` — когда Битрикс24 отказал в вызове — в `error` только его собственный текст, без `processedUserIds` и `skippedUserIds`

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

JSON

{
  "success": true,
  "data": {
    "groupId": 157,
    "processedUserIds": [93],
    "skippedUserIds": []
  }
}

Пример ответа при ошибке

422 — пользователь уже приглашён и ещё не ответил: