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

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

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

post /users создание нового сотрудника
Запрос
user object* Собранный объект параметров создаваемого сотрудника
first_name string* Имя
last_name string Фамилия
nickname string Имя пользователя
email string* Электронная почта
phone_number string Телефон
department string Подразделение
role string Уровень доступа: admin (администратор), user (сотрудник)
suspended boolean Приостановка доступа
list_tags array of strings Массив тегов, привязываемых к сотруднику
custom_properties array of objects Задаваемые дополнительные поля
id integer Идентификатор поля
value string Устанавливаемое значение
Ответ
data object Созданный сотрудник
id integer Идентификатор созданного пользователя
first_name string Имя
last_name string Фамилия
nickname string Имя пользователя
email string Электронная почта
phone_number string Телефон
department string Подразделение
role string Уровень доступа: admin (администратор), user (сотрудник)
suspended boolean Приостановка доступа
list_tags array of strings Массив тегов, привязанных к сотруднику
custom_properties array of objects Дополнительные поля сотрудника
id integer Идентификатор поля
name string Название поля
data_type string Тип поля (string, number, date или link)
value string Значение
Возможные ошибки запроса (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": "Санкт-Петербург"
      }
    ]
  }
}
{
  "data": {
    "id": 12,
    "first_name": "Олег",
    "last_name": "Петров",
    "nickname": "",
    "email": "olegp@example.com",
    "phone_number": "",
    "department": "Продукт",
    "role": "admin",
    "suspended": false,
    "list_tags": [
      "Product",
      "Design"
    ],
    "custom_properties": [
      {
        "id": 1678,
        "name": "Город",
        "data_type": "string",
        "value": "Санкт-Петербург"
      }
    ]
  }
}