> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exode.biz/llms.txt
> Use this file to discover all available pages before exploring further.
# Создание пользователя
> Создание нового пользователя в школе с указанием данных профиля
## Заголовки запроса
API токен сервисного пользователя в формате Bearer. Получите токен в панели администратора школы. Формат: `Bearer YOUR_TOKEN`.
Уникальный идентификатор продавца в системе. Используется для разграничения доступа между разными продавцами.
Уникальный идентификатор школы в системе. Определяет контекст выполнения операции.
```
POST /saas/v2/user/create
```
Требуется аутентификация и право `SchoolManageUsers`.
## Параметры запроса
##### Для определения логина — передайте хотя бы один из ниже перечисленных параметров
Логин и пароль для входа отправляется **автоматически**.
Если не передать одно из полей ниже — то вам необходимо будет получить пароль и отправить его самостоятельно в
настройках пользователя
Если передать поле `password` — пользователю будет установлен указанный пароль, а автоматическая генерация и
отправка пароля выполняться **не будет**.
Для отпарвки логина и пароля в Telegram — пользователь должен дать разрешение писать боту или иметь активный чат с
этим ботом
Email адрес пользователя. Должен быть валидным email форматом. При передаче пустой строки — преобразуется в
`null`.
Номер телефона пользователя. Должен быть в международном формате (например, +9876543210). При передаче пустой строки — преобразуется в `null`.
Telegram ID пользователя. Целое число или `null`.
Внешний идентификатор пользователя из вашей системы. Строка до 50 символов или `null`. При передаче пустой
строки — преобразуется в `null`.
Создать пользователя сразу заблокированным. По умолчанию `false`.
Пароль пользователя. От 6 до 100 символов. Если передан — устанавливается как пароль для входа, автоматическая
отправка сгенерированного пароля пропускается. При передаче пустой строки — преобразуется в `null`.
Доступно только при создании (в `update` поле не поддерживается).
### Параметры профиля
Объект с данными профиля пользователя.
Имя пользователя. Максимум 15 символов, только буквы (латиница и кириллица) и пробелы. Автоматически
обрезаются пробелы в начале и конце.
Фамилия пользователя. Максимум 15 символов, только буквы (латиница и кириллица) и пробелы. Автоматически
обрезаются пробелы в начале и конце.
Дата рождения в формате YYYY-MM-DD.
Пол пользователя. Возможные значения: `Ufo`, `Women`, `Men`.
Роль пользователя. Возможные значения: `Student`, `Tutor`, `Parent`.
При создании пользователя автоматически создается связанный профиль с указанными данными. Если профиль не указан,
создается пустой профиль, поля `firstName` и `lastName` будут заполнены пользователем при первом входе в аккаунт.
```bash cURL theme={null}
curl --location 'https://api.exode.biz/saas/v2/user/create' \
--header 'Seller-Id: {{ sellerId }}' \
--header 'School-Id: {{ schoolId }}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--data-raw '{
"email": "user@example.com",
"phone": "+9876543210",
"extId": "crm_12345",
"tgId": null,
"password": "SecurePass123",
"profile": {
"firstName": "Firstname",
"lastName": "Lastname",
"bdate": "1990-01-01",
"sex": "Men",
"role": "Student"
}
}'
```
```javascript Node.js theme={null}
const axios = require('axios');
const createUser = async () => {
try {
const response = await axios.post('https://api.exode.biz/saas/v2/user/create', {
email: 'user@example.com',
phone: '+9876543210',
extId: 'crm_12345',
tgId: null,
password: 'SecurePass123',
profile: {
firstName: 'Firstname',
lastName: 'Lastname',
bdate: '1990-01-01',
sex: 'Men',
role: 'Student'
}
}, {
headers: {
'Seller-Id': '{{ sellerId }}',
'School-Id': '{{ schoolId }}',
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_TOKEN'
}
});
console.log('User created:', response.data.payload);
} catch (error) {
console.error('Error:', error.response?.data || error.message);
}
};
createUser();
```
```php PHP theme={null}
'user@example.com',
'phone' => '+9876543210',
'extId' => 'crm_12345',
'tgId' => null,
'password' => 'SecurePass123',
'profile' => [
'firstName' => 'Firstname',
'lastName' => 'Lastname',
'bdate' => '1990-01-01',
'sex' => 'Men',
'role' => 'Student'
]
];
$headers = [
'Seller-Id: {{ sellerId }}',
'School-Id: {{ schoolId }}',
'Content-Type: application/json',
'Authorization: Bearer YOUR_TOKEN'
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode === 200) {
$result = json_decode($response, true);
echo "User created successfully\n";
print_r($result['payload']);
} else {
echo "Error: HTTP $httpCode\n";
echo $response;
}
?>
```
```python Python theme={null}
import requests
import json
url = 'https://api.exode.biz/saas/v2/user/create'
data = {
'email': 'user@example.com',
'phone': '+9876543210',
'extId': 'crm_12345',
'tgId': None,
'password': 'SecurePass123',
'profile': {
'firstName': 'Firstname',
'lastName': 'Lastname',
'bdate': '1990-01-01',
'sex': 'Men',
'role': 'Student'
}
}
headers = {
'Seller-Id': '{{ sellerId }}',
'School-Id': '{{ schoolId }}',
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_TOKEN'
}
try:
response = requests.post(url, json=data, headers=headers)
response.raise_for_status()
result = response.json()
print('User created successfully:')
print(json.dumps(result['payload'], indent=2, ensure_ascii=False))
except requests.exceptions.RequestException as e:
print(f'Error: {e}')
if hasattr(e, 'response') and e.response is not None:
print(f'Response: {e.response.text}')
```
```bsl 1С theme={null}
Профиль = Новый Структура;
Профиль.Вставить("firstName", "Firstname");
Профиль.Вставить("lastName", "Lastname");
Профиль.Вставить("bdate", "1990-01-01");
Профиль.Вставить("sex", "Men");
Профиль.Вставить("role", "Student");
Данные = Новый Структура;
Данные.Вставить("email", "user@example.com");
Данные.Вставить("phone", "+9876543210");
Данные.Вставить("extId", "crm_12345");
Данные.Вставить("tgId", Неопределено);
Данные.Вставить("password", "SecurePass123");
Данные.Вставить("profile", Профиль);
// Serialize body to JSON
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписатьJSON(ЗаписьJSON, Данные);
ТелоЗапроса = ЗаписьJSON.Закрыть();
Соединение = Новый HTTPСоединение("api.exode.biz", 443, , , , 30, Новый OpenSSLSecureConnection);
Запрос = Новый HTTPЗапрос("/saas/v2/user/create");
Запрос.Заголовки.Вставить("Seller-Id", "{{ sellerId }}");
Запрос.Заголовки.Вставить("School-Id", "{{ schoolId }}");
Запрос.Заголовки.Вставить("Content-Type", "application/json");
Запрос.Заголовки.Вставить("Authorization", "Bearer YOUR_TOKEN");
Запрос.УстановитьТелоИзСтроки(ТелоЗапроса);
Ответ = Соединение.ВызватьHTTPМетод("POST", Запрос);
Если Ответ.КодСостояния = 200 Тогда
ЧтениеJSON = Новый ЧтениеJSON;
ЧтениеJSON.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку());
Результат = ПрочитатьJSON(ЧтениеJSON);
Сообщить("Пользователь создан");
Иначе
Сообщить("Ошибка: HTTP " + Ответ.КодСостояния);
Сообщить(Ответ.ПолучитьТелоКакСтроку());
КонецЕсли;
```
```json Success theme={null}
{
"success": true,
"code": 201,
"payload": {
"user": {
"id": 1683,
"createdAt": "2026-07-02T11:15:46.896Z",
"updatedAt": "2026-07-02T11:15:46.940Z",
"archivedAt": null,
"uuid": "e-cjTT0CWMCB",
"active": true,
"activated": true,
"banned": false,
"alive": true,
"domain": "id1683",
"email": "user@example.com",
"phone": "+9876543210",
"tgId": null,
"vkId": null,
"appleId": null,
"extId": "crm_12345",
"schoolId": 198,
"language": null,
"timezone": null,
"lastOnlineAt": null,
"starsBalance": 0,
"currentTime": "2026-07-02T11:15:46+00:00",
"isSleepingNow": false,
"profile": {
"id": 1665,
"createdAt": "2026-07-02T11:15:46.932Z",
"updatedAt": "2026-07-02T11:15:46.932Z",
"archivedAt": null,
"userId": 1683,
"official": false,
"firstName": "Firstname",
"lastName": "Lastname",
"fullName": "Firstname Lastname",
"fullNameShort": "Firstname L.",
"bdate": "1990-01-01",
"sex": "Men",
"country": null,
"city": null,
"role": "Student",
"status": null,
"title": "",
"emojiTitle": "",
"avatar": {
"id": 1665,
"small": "https://storage.exode.biz/production/user/1683/xK2mVwNib9b0/small/avatar.png",
"medium": "https://storage.exode.biz/production/user/1683/xK2mVwNib9b0/medium/avatar.png",
"maximum": "https://storage.exode.biz/production/user/1683/xK2mVwNib9b0/avatar.png"
},
"titleState": {
"manualTitle": null,
"manualEmojiTitle": null,
"manualNextTitle": null,
"manualNextEmojiTitle": null,
"manualExpiredAt": null,
"locationTitle": null,
"locationEmojiTitle": null,
"achievementTitle": null,
"achievementEmojiTitle": null
}
}
}
}
}
```
```json Error - User Already Exists theme={null}
{
"code": 400,
"success": false,
"cause": "UserAlreadyExists",
"message": "User already exists",
"error": "User already exists"
}
```
```json Error - Invalid Email theme={null}
{
"code": 400,
"success": false,
"cause": "EmailIsBusy",
"message": "Email is busy",
"error": "Email is busy"
}
```
```json Error - Invalid Phone theme={null}
{
"code": 400,
"success": false,
"cause": "InvalidPhone",
"message": "Phone must be a valid phone number",
"error": "Phone must be a valid phone number"
}
```
```json Error - Invalid First Name theme={null}
{
"code": 400,
"success": false,
"cause": "InvalidFirstName",
"message": "First name must match required format",
"error": "First name must match required format"
}
```
## Требования к правам доступа
Для создания пользователя требуется **право на управление пользователями школы**.
Сервисный пользователь должен быть аутентифицирован по токену и иметь соответствующие права доступа к указанной
школе.