Создать сотрудника

POST/users
users:create

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

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

Тело запроса

application/json
user
object
*
first_name
string
Имя
Пример:Олег
last_name
string
Фамилия
Пример:Петров
email
string
*
Электронная почта
Пример:olegp@example.com
phone_number
string
Телефон
Пример:+79001234567
nickname
string
Имя пользователя
Пример:olegpetrov
department
string
Департамент
Пример:Продукт
title
string
Должность
Пример:CIO
role
string
Уровень доступа
Возможные значения
Пример:user
suspended
boolean
Деактивация пользователя
Пример:false
list_tags[]
array of strings
Массив тегов, привязываемых к сотруднику
Пример:["Product","Design"]
custom_properties[]
array of objects
Задаваемые дополнительные поля
id
integer, (int32)
*
Идентификатор поля
Пример:1678
value
string
*
Устанавливаемое значение
Пример:Санкт-Петербург
skip_email_notify
boolean
Пропуск этапа отправки приглашения сотруднику. Сотруднику не будет отправлено письмо на электронную почту с приглашением создать аккаунт. Полезно при предварительном создании аккаунтов перед входом через SSO.
Пример:true

Ответ

201Created
The request has succeeded and a new resource has been created as a result.
data
object
*
Сотрудник
id
integer, (int32)
*
Идентификатор пользователя
Пример:12
first_name
string
*
Имя
Пример:Олег
last_name
string
*
Фамилия
Пример:Петров
nickname
string
*
Имя пользователя
Пример:
email
string
*
Электронная почта
Пример:olegp@example.com
phone_number
string
*
Телефон
Пример:
department
string
*
Департамент
Пример:Продукт
title
string
*
Должность
Пример:CIO
role
string
*
Уровень доступа
Возможные значения
Пример:admin
suspended
boolean
*
Деактивация пользователя
Пример:false
invite_status
string
*
Статус приглашения
Возможные значения
Пример:confirmed
list_tags[]
array of strings
*
Массив тегов, привязанных к сотруднику
Пример:["Product","Design"]
custom_properties[]
array of objects
*
Дополнительные поля сотрудника
id
integer, (int32)
*
Идентификатор поля
Пример:1678
name
string
*
Название поля
Пример:Город
data_type
string
*
Тип поля
Возможные значения
Пример:string
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
Пример:2024-04-08T10:00:00.000Z
is_away
boolean
*
Режим «Нет на месте»
Пример:false
away_message
nullableobject
*
Сообщение при режиме «Нет на месте». Отображается в профиле пользователя, а также при отправке ему личного сообщения или упоминании в чате.
text
string
*
Текст сообщения
Пример:Я в отпуске до 15 апреля. По срочным вопросам обращайтесь к @ivanov.
bot
boolean
*
Является ботом
Пример:false
sso
boolean
*
Использует ли пользователь SSO
Пример:false
created_at
string, (date-time)
*
Дата создания (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
Пример:2020-06-08T09:32:57.000Z
last_activity_at
string, (date-time)
*
Дата последней активности пользователя (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
Пример:2025-01-20T13:40:07.000Z
time_zone
string
*
Часовой пояс пользователя
Пример:Europe/Moscow
image_url
nullablestring
*
Ссылка на скачивание аватарки пользователя
Пример:https://app.pachca.com/users/12/photo.jpg
Создать сотрудника
pachca users create \  --first-name=Олег \  --last-name=Петров \  --email=olegp@example.com \  --phone-number=+79001234567 \  --nickname=olegpetrov \  --department=Продукт \  --title=CIO \  --role=user \  --no-suspended \  --list-tags=Product,Design \  --custom-properties='[{"id":1678,"value":"Санкт-Петербург"}]' \  --skip-email-notify \  --json \  --token YOUR_ACCESS_TOKEN
Ответ 201
{  "data": {    "id": 12,    "first_name": "Олег",    "last_name": "Петров",    "nickname": "",    "email": "olegp@example.com",    "phone_number": "",    "department": "Продукт",    "title": "CIO",    "role": "admin",    "suspended": false,    "invite_status": "confirmed",    "list_tags": [      "Product",      "Design"    ],    "custom_properties": [      {        "id": 1678,        "name": "Город",        "data_type": "string",        "value": "Санкт-Петербург"      }    ],    "user_status": {      "emoji": "🎮",      "title": "Очень занят",      "expires_at": "2024-04-08T10:00:00.000Z",      "is_away": false,      "away_message": {        "text": "Я в отпуске до 15 апреля. По срочным вопросам обращайтесь к @ivanov."      }    },    "bot": false,    "sso": false,    "created_at": "2020-06-08T09:32:57.000Z",    "last_activity_at": "2025-01-20T13:40:07.000Z",    "time_zone": "Europe/Moscow",    "image_url": "https://app.pachca.com/users/12/photo.jpg"  }}