Создать пользователя

Создает нового пользователя по структуре полей

Функция СоздатьПользователя(Знач URL, Знач СтруктураПолей, Знач Токен = "") Экспорт

Параметр	CLI опция	Тип	Обяз.	Назначение
URL	--url	Строка	✔	URL внешнего вебхука или адрес Bitrix24 при использовании токена
СтруктураПолей	--fields	Структура Из КлючИЗначение	✔	Данные пользователя. См. ПолучитьСтурктуруПользователя
Токен	--token	Строка	✖	Токен авторизации, если используется не вебхук

Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Bitrxi24

подсказка

Метод в документации API: user.add

Если нужно добавить пользователя экстранета, то в полях необходимо передать: EXTRANET: Y и SONET_GROUP_ID: [...]

Если нужно добавить пользователя интранета, то обязательно передаётся: UF_DEPARTMENT: [...]

Пример использования для 1С:Предприятие/OneScript
    URL   = "https://b24-ar17wx.bitrix24.by/rest/1/h0m...";
    Почта = Строка(Новый УникальныйИдентификатор) + "@exepmple.org";
    // Полную структуру можно получить функцией ПолучитьСтурктуруПользователя

    СтруктураПользователя = Новый Структура;
    СтруктураПользователя.Вставить("EMAIL"        , Почта);
    СтруктураПользователя.Вставить("UF_DEPARTMENT", 7);

    Результат = OPI_Bitrix24.СоздатьПользователя(URL, СтруктураПользователя);

    URL   = "b24-ar17wx.bitrix24.by";
    Токен = "f85df267006e9f06006b12e400000001000...";
    Почта = Строка(Новый УникальныйИдентификатор) + "@exepmple.org";

    СтруктураПользователя = Новый Структура;
    СтруктураПользователя.Вставить("EMAIL"          , Почта);
    СтруктураПользователя.Вставить("NAME"           , "Виталий");
    СтруктураПользователя.Вставить("LAST_NAME"      , "Альпака");
    СтруктураПользователя.Вставить("PERSONAL_MOBILE", "88003553535");
    СтруктураПользователя.Вставить("UF_DEPARTMENT"  , 1);

    Результат = OPI_Bitrix24.СоздатьПользователя(URL, СтруктураПользователя, Токен);

Bash
CMD/Bat

    # JSON данные также могут быть переданы как путь к файлу .json
    
    oint bitrix24 СоздатьПользователя \
      --url "b24-ar17wx.bitrix24.by" \
      --fields "{'EMAIL':'5fa680f2-9621-413b-8db2-f4b86859df79@exepmple.org','NAME':'Виталий','LAST_NAME':'Альпака','PERSONAL_MOBILE':'88003553535','UF_DEPARTMENT':1}" \
      --token "***"

    :: JSON данные также могут быть переданы как путь к файлу .json
    
    oint bitrix24 СоздатьПользователя ^
      --url "b24-ar17wx.bitrix24.by" ^
      --fields "{'EMAIL':'5fa680f2-9621-413b-8db2-f4b86859df79@exepmple.org','NAME':'Виталий','LAST_NAME':'Альпака','PERSONAL_MOBILE':'88003553535','UF_DEPARTMENT':1}" ^
      --token "***"

Результат
{
 "result": 598,
 "time": {
  "start": 1728409874.69828,
  "finish": 1728409876.61938,
  "duration": 1.92110395431519,
  "processing": 1.89232087135315,
  "date_start": "2024-10-08T20:51:14+03:00",
  "date_finish": "2024-10-08T20:51:16+03:00",
  "operating_reset_at": 1728410474,
  "operating": 1.89229583740234
 }
}