Создать пользователя
POST /users/
Пример URL
https://домен_системы/api/v2/users/
Параметры тела запроса (JSON)
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
name | строка | Да | Имя пользователя |
email | строка | Да | Э-почта пользователя |
password | строка | Да | Пароль пользователя |
group_id | число | Да | ID группы пользователя |
department | массив | Да | ID доступных департаментов |
lastname | строка | Нет | Фамилия |
alias | строка | Нет | Псевдоним |
phone | строка | Нет | Телефон |
skype | строка | Нет | Скайп |
website | строка | Нет | Адрес сайта |
organization | строка | Нет | Название новой или существующей компании; Если заполнено — поле "organiz_id" не учитывается |
organiz_id | число | Нет | ID существующей компании; Не учитывается, если заполнено "organization" |
status | строка | Нет | Статус пользователя: active - активен; disabled - заблокирован; fired - уволен |
language | строка | Нет | Язык пользователя |
notifications | boolean | Нет | Уведомления на почту: 0 - отключены; 1 - включены |
user_status | строка | Нет | Статус активности пользователя |
custom_fields | объект | Нет | Массив индивидуальных полей контактов |
Пример тела запроса (JSON)
{
"name":"Иван",
"email":"email@example.com",
"department":[1],
"password":"abc123",
"group_id": 1,
"lastname":"Иванов", // для указания пустого значения ""
"phone": "+7 123 123‒45‒67", // для указания пустого значения ""
"skype":"skype", // для указания пустого значения ""
"website":"example.com", // для указания пустого значения ""
"organization":"Новая организация", // для указания пустого значения ""
// "organiz_id":1, // Не учитывается, если заполнено "organization"
"status":"active",
"language":"ru",
"notifications":0,
"user_status":"online",
"custom_fields":{
"113": "Значение поля с типом (Текстовое поле)", // Пример для поля c типом "Текстовое поле" (ID = 113), для установки пустого значения указать ""
"114": "Значение поля с типом (Текстовая область)", // Пример для поля с типом "Текстовая область" (ID = 114), для установки пустого значения указать ""
"115": "450", // Пример для поля с типом "Выпадающий список" (ID = 115), необходимо указать ID значений из поля, для установки пустого значения указать ""
"116":{ // Пример поля с типом "Связанные поля" (ID = 116)
"1": 452, // Значение ID-поля первого уровня
"2": 454 // Значение ID-поля второго уровня
},
// "116":{
// "1": 0, // Структура для указания пустового значения с типом "Связанные поля"
// }
"117": "1", // Пример для поля с типом "Флажок (чекбокс)" (ID = 117), для установки пустого значения указать ""
"118": "01.01.2027", // Пример для поля с типом "Дата" (ID = 118), для установки пустого значения указать ""
"119": "1" // Пример поля с типом "Числовое поле" (ID = 119), для установки пустого значения указать ""
}
}
Пример ответа
{
"data": {
"id": 1,
"date_created": "2025-10-17 11:08:43",
"date_updated": "2025-10-17 11:08:43",
"name": "Иван",
"lastname": "Иванов",
"alias": "Техническая поддержка",
"email": "email@example.com",
"phone": "+7 123 123‒45‒67",
"skype": "skype",
"website": "example.com",
"organization": {
"id": "1",
"name": "Новая организация",
"domains": "",
"address": "",
"phone": "",
"email": "",
"web": ""
},
"status": "active",
"language": "ru",
"notifications": "1",
"group": {
"id": 1,
"type": "user",
"name": {
"ru": "Клиент",
"en": "Client",
"ua": "-"
},
"disable": 0
},
"ldap_username": null,
"user_status": "online",
"department": [
1
],
"custom_fields": [
{
"id": 113,
"field_type": "text",
"field_value": "Значение поля с типом (Текстовое поле)"
},
{
"id": 114,
"field_type": "textarea",
"field_value": "Значение поля с типом (Текстовая область)"
},
{
"id": 115,
"field_type": "select",
"field_value": {
"id": 450,
"name": {
"ru": "Значение 1"
}
}
},
{
"id": 116,
"field_type": "hierarchy",
"field_value": {
"1": {
"id": 452,
"name": {
"ru": "Родительский элемент первого уровня"
}
},
"2": {
"id": 454,
"name": {
"ru": "Дочерний элемент второго уровня"
}
}
}
},
{
"id": 117,
"field_type": "checkbox",
"field_value": 1
},
{
"id": 118,
"field_type": "date",
"field_value": "01.01.2027"
},
{
"id": 119,
"field_type": "number",
"field_value": "1"
}
],
"api_key": "177f3809-3fff-4f52-b2ac-ffc68f59d713"
}
}