Создать сотрудника
POST/users
Данный метод доступен для работы только с
Бот пока не может работать с подобными методами и взаимодействует с API на уровне обычного участника пространства.
access_token администратора пространства. Подробнее о том, как получить такой токен, вы можете прочитать в разделе Запросы и ответы.Бот пока не может работать с подобными методами и взаимодействует с API на уровне обычного участника пространства.
Метод для создания нового сотрудника в вашей компании.
Вы можете заполнять дополнительные поля сотрудника, которые созданы в вашей компании. Получить актуальный список идентификаторов дополнительных полей сотрудника вы можете в методе GETСписок дополнительных полей.
Тело запроса
application/jsonuser
object
*first_name
string
Имя
last_name
string
Фамилия
email
string
*Электронная почта
phone_number
string
Телефон
nickname
string
Имя пользователя
department
string
Департамент
title
string
Должность
role
string
Уровень доступа
Возможные значения
adminАдминистратор
userСотрудник
multi_guestМульти-гость
suspended
boolean
Деактивация пользователя
list_tags[]
array of strings
Массив тегов, привязываемых к сотруднику
custom_properties[]
array of objects
Задаваемые дополнительные поля
id
integer, (int32)
*Идентификатор поля
value
string
*Устанавливаемое значение
skip_email_notify
boolean
Пропуск этапа отправки приглашения сотруднику. Сотруднику не будет отправлено письмо на электронную почту с приглашением создать аккаунт. Полезно при предварительном создании аккаунтов перед входом через SSO.
Ответ
201Created
The request has succeeded and a new resource has been created as a result.
data
object
*Сотрудник
id
integer, (int32)
*Идентификатор пользователя
first_name
string
*Имя
last_name
string
*Фамилия
nickname
string
*Имя пользователя
email
string
*Электронная почта
phone_number
string
*Телефон
department
string
*Департамент
title
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, (int32)
*Идентификатор поля
name
string
*Название поля
data_type
string
*Тип поля
Возможные значения
stringСтроковое значение
numberЧисловое значение
dateДата
linkСсылка
value
string
*Значение
user_status
nullableobject
*Статус
emoji
string
*Emoji символ статуса
title
string
*Текст статуса
expires_at
nullablestring, (date-time)
*Срок жизни статуса (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
bot
boolean
*Является ботом
sso
boolean
*Использует ли пользователь SSO
created_at
string, (date-time)
*Дата создания (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
last_activity_at
string, (date-time)
*Дата последней активности пользователя (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
time_zone
string
*Часовой пояс пользователя
image_url
nullablestring
*Ссылка на скачивание аватарки пользователя