# onUserAdd

URL: https://chugunov.pro/api-bitrix24/common/events/on-user-add/
Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c).
Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является.

Событие при добавлении пользователя
Scope: `user`
Кто может подписаться: любой пользователь

## Описание

Событие `ONUSERADD` вызывается при добавлении пользователя в Битрикс24. Событие срабатывает не после приглашения, а после того, как пользователь зайдет в Битрикс24 и завершит регистрацию.

События не будут отправляться в приложение, пока установка не завершена. [Проверьте установку приложения](https://apidocs.bitrix24.ru/settings/app-installation/installation-finish.html)

## Параметры

- `event` `string` — обязательный. Символьный код события — `ONUSERADD`
- `data` `object` — обязательный. Данные добавленного пользователя.
  Структура описана [ниже](#data)
- `ts` `timestamp` — обязательный. Дата и время отправки события
- `auth` `object` — обязательный. Данные авторизации и Битрикс24.
  Структура описана [ниже](#auth)

### Параметр data

- `ID` `integer` — обязательный. Идентификатор пользователя
- `ACTIVE` `string` — обязательный. Флаг активности.
  Возможные значения:
  - `Y` — да
  - `N` — нет
- `EMAIL` `string` — необязательный. Email пользователя
- `NAME` `string` — необязательный. Имя пользователя
- `LAST_NAME` `string` — необязательный. Фамилия пользователя
- `PERSONAL_GENDER` `string` — необязательный. Пол: `M` — мужской, `F` — женский
- `PERSONAL_BIRTHDAY` `string` — необязательный. Дата рождения в формате `YYYY-MM-DD`
- `UF_DEPARTMENT` `array` — необязательный. Массив `ID` подразделений. Может отсутствовать для пользователей Экстранет
- `DATE_REGISTER` `string` — обязательный. Дата регистрации в формате `ISO 8601`
- `WORK_POSITION` `string` — необязательный. Должность пользователя
- `UF_EMPLOYMENT_DATE` `string` — необязательный. Дата приема на работу в формате `YYYY-MM-DD`

### Параметр auth

- `access_token` `string` — обязательный. Токен для обращения к API
- `expires_in` `integer` — обязательный. Время в секундах до истечения срока действия токена
- `scope` `string` — обязательный. [Скоуп](https://apidocs.bitrix24.ru/api-reference/scopes/permissions.html), в рамках которого произошло событие
- `domain` `string` — обязательный. Адрес Битрикс24, на котором произошло событие
- `server_endpoint` `string` — обязательный. Адрес сервера авторизации Битрикс24, необходимый для обновления токенов OAuth 2.0
- `status` `string` — обязательный. Статус приложения, подписавшегося на это событие:
  - `L` — [локальное](https://apidocs.bitrix24.ru/local-integrations/local-apps.html) приложение
  - `F` — [бесплатное тиражное](https://apidocs.bitrix24.ru/market/index.html) приложение
  - `S` — [подписное тиражное](https://apidocs.bitrix24.ru/market/monetization/index.html) приложение
- `client_endpoint` `string` — обязательный. Общий путь для вызовов методов API для Битрикс24, на котором произошло событие
- `member_id` `string` — обязательный. Идентификатор Битрикс24, на котором произошло событие
- `application_token` `string` — обязательный. Токен для безопасной обработки событий

Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/common/events/on-user-add.html