Новый сотрудник

Метод для создания нового сотрудника в вашей компании.

Вы можете заполнять дополнительные поля сотрудника, которые созданы в вашей компании. Получить актуальный список идентификаторов дополнительных полей сотрудника вы можете в методе Список дополнительных полей.

Запрос
user	object*	Собранный объект параметров создаваемого сотрудника
first_name	string	Имя
last_name	string	Фамилия
nickname	string	Имя пользователя
email	string*	Электронная почта
phone_number	string	Телефон
department	string	Подразделение
role	string	Уровень доступа: admin (администратор), user (сотрудник), multi_guest (мульти-гость)
suspended	boolean	Приостановка доступа
list_tags	array of strings	Массив тегов, привязываемых к сотруднику
custom_properties	array of objects	Задаваемые дополнительные поля
id	integer	Идентификатор поля
value	string	Устанавливаемое значение
skip_email_notify	boolean	Пропуск этапа отправки приглашения сотруднику (при значении true сотруднику не будет отправлено письмо на электронную почту с приглашением создать аккаунт). Данный параметр полезен в случае предварительного создания аккаунтов сотрудникам перед их входом через SSO.
Ответ
data	object	Созданный сотрудник
id	integer	Идентификатор созданного пользователя
first_name	string	Имя
last_name	string	Фамилия
nickname	string	Имя пользователя
email	string	Электронная почта
phone_number	string	Телефон
department	string	Подразделение
role	string	Уровень доступа: admin (администратор), user (сотрудник), multi_guest (мульти-гость)
suspended	boolean	Приостановка доступа
invite_status	string	Статус пришлашения: confirmed (принято), sent (отправлено)
list_tags	array of strings	Массив тегов, привязанных к сотруднику
custom_properties	array of objects	Дополнительные поля сотрудника
id	integer	Идентификатор поля
name	string	Название поля
data_type	string	Тип поля (string, number, date или link)
value	string	Значение
user_status	object или null	Статус. Возвращается как null, если статус не установлен.
emoji	string	Emoji символ статуса
title	string	Текст статуса
expires_at	string или null	Срок жизни статуса (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ. Возвращается как null, если срок не установлен.
bot	boolean	Тип: пользователь (false) или бот (true)
created_at	string	Дата создания (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
Возможные ошибки запроса (errors code)
blank	Обязательное поле (не может быть пустым)
too_long	Слишком длинное значение (пояснения вы получите в поле message)
invalid	Поле не соответствует правилам (пояснения вы получите в поле message)
licenses_limit	Превышен лимит активных сотрудников (пояснения вы получите в поле message)

* обязательно ** обязательно наличие хотя бы одного из параметров

{
  "user": {
    "first_name": "Олег",
    "last_name": "Петров",
    "email": "olegp@example.com",
    "department": "Продукт",
    "list_tags": [
      "Product",
      "Design"
    ],
    "custom_properties": [
      {
        "id": 1678,
        "value": "Санкт-Петербург"
      }
    ]
  },
  "skip_email_notify": true
}

{
  "data": {
    "id": 12,
    "first_name": "Олег",
    "last_name": "Петров",
    "nickname": "",
    "email": "olegp@example.com",
    "phone_number": "",
    "department": "Продукт",
    "role": "admin",
    "suspended": false,
    "invite_status": "confirmed",
    "list_tags": [
      "Product",
      "Design"
    ],
    "custom_properties": [
      {
        "id": 1678,
        "name": "Город",
        "data_type": "string",
        "value": "Санкт-Петербург"
      }
    ],
    "user_status": null,
    "bot": false,
    "created_at": "2023-06-08T09:31:17.000Z"
  }
}