Создать заявку
POST /tickets/
Пример URL
https://домен_системы/api/v2/tickets/
Параметры тела запроса (JSON)
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
pid | число | Нет | ID родительской заявки |
title | строка | Да | Тема (название) заявки |
description | строка | Да | Описание заявки |
sla_date | дата | Нет | Дата и время SLA (DD.MM.YYYY H:S) |
status_id | строка | Нет | ID статуса заявки |
priority_id | число | Нет | ID приоритета заявки |
type_id | число | Нет | ID типа заявки |
department_id | число | Нет | ID департамента заявки |
ticket_lock | число boolean | Нет | Блокировка заявки (true или 1 - заблокирована, false или 0 - разблокирована); По умолчанию: false |
owner_id | число | Нет | ID исполнителя заявки |
user_id | число | Нет | ID владельца (клиента) заявки |
user_email | строка | Нет | Почта клиента. Если не задан user_id, заявка создается по указанному email. Если пользователь с таким email отсутствует, он создается автоматически |
cc | массив | Нет | Адресаты копий письма |
bcc | массив | Нет | Адресаты скрытых копий письма |
followers | массив | Нет | Список пользователей следящих за заявкой, тип пользователя должен быть сотрудником |
create_from_user | число boolean | Нет | Первый ответ в заявке от имени клиента - 1 или true;От имени сотрудника - 0 или false;Значение по умолчанию - 1 |
custom_fields | объект | Нет | Индивидуальные поля заявки |
tags | массив | Нет | Список меток |
files | массив | Нет | Список файлов (только для form-data) |
Пример тела запроса (JSON)
{
"pid":"1",
"title": "Тестовая заявка",
"description": "Описание заявки",
"sla_date":"01.01.2026 00:00", // для указания пустого значения ""
"status_id":"open",
"priority_id":1,
"type_id":1,
"department_id":1,
"ticket_lock":false,
"owner_id": 1, // для указания пустого значения ""
"user_id": 1,
"user_email":"email@example.com", // для указания пустого значения ""
"cc":["email@example.com","email2@example.com"], // для указания пустого значения []
"bcc":["email@example.com","email2@example.com"], // для указания пустого значения []
"followers":[1], // для указания пустого значения []
"create_from_user":1,
"custom_fields":{ //пример для связанного списка с ID = 130
"96": "Значение поля с типом (Текстовое поле)", // Пример для поля c типом "Текстовое поле" (ID = 96), для установки пустого значения указать ""
"97": "Значение поля с типом (Текстовая область)", // Пример для поля с типом "Текстовая область" (ID = 97), для установки пустого значения указать ""
"98": "1", // Пример поля с типом "Числовое поле" (ID = 98), для установки пустого значения указать ""
"99": "192", // Пример для поля с типом "Выпадающий список" (ID = 99), необходимо указать ID значений из поля, для установки пустого значения указать ""
"100":{ // Пример поля с типом "Связанные поля" (ID = 100)
"1": 198, // Значение ID-поля первого уровня
"2": 204 // Значение ID-поля второго уровня
},
// "100":{
// "1": 0, // Структура для указания пустового значения с типом "Связанные поля"
// }
"101": "01.01.2027", // Пример для поля с типом "Дата" (ID = 101), для установки пустого значения указать ""
"102": "09:00", // Пример для поля с типом "Время" (ID = 102), для установки пустого значения указать ""
"103": "example@mail.com", // Пример для поля с типом "Регулярное выражение" (ID = 103), для установки пустого значения указать ""
"104": "1", // Пример для поля с типом "Флажок (чекбокс)" (ID = 104), для установки пустого значения указать ""
"105": "1", // Пример для поля с типом "Кнопка" (ID = 105), для установки пустого значения указать ""
"105": "45928", // Пример для поля с типом "Мультикнопка" (ID = 106), необходимо указать ID значений из поля, для установки пустого значения указать ""
},
"tags":[1,2] // для указания пустого значения []
}
Пример ответа
{
"data": {
"id": 2,
"pid": 1,
"unique_id": "ABC-124",
"date_created": "2025-11-21 09:40:47",
"date_updated": "2025-11-21 10:33:34",
"title": "Тестовая заявка",
"source": "system",
"status_id": "open",
"priority_id": 1,
"type_id": 1,
"department_id": 1,
"department_name": "Отдел поддержки",
"owner_id": 1,
"owner_name": "Administrator",
"owner_lastname": "",
"owner_email": "email@example.com",
"user_id": 1,
"user_name": "user1",
"user_lastname": "",
"user_email": "email4@example.com",
"cc": [
"email@example.com",
"email2@example.com"
],
"bcc": [
"email@example.com",
"email2@example.com"
],
"followers": [
1
],
"ticket_lock": 0,
"sla_date": "01.01.2026 00:00",
"sla_flag": 0,
"freeze_date": null,
"freeze": 0,
"viewed_by_staff": 1,
"viewed_by_client": 0,
"rate": "",
"rate_comment": "",
"rate_date": "",
"deleted": 0,
"custom_fields": [
{
"id": 96,
"field_type": "text",
"field_value": "Значение поля с типом (Текстовое поле)"
},
{
"id": 97,
"field_type": "textarea",
"field_value": "Значение поля с типом (Текстовая область)"
},
{
"id": 98,
"field_type": "number",
"field_value": "1"
},
{
"id": 99,
"field_type": "select",
"field_value": {
"id": 192,
"name": {
"ru": "Значение 1",
"en": "",
"ua": ""
}
}
},
{
"id": 100,
"field_type": "hierarchy",
"field_value": {
"1": {
"id": 198,
"name": {
"ru": "Родительский элемент первого уровня"
}
},
"2": {
"id": 204,
"name": {
"ru": "Дочерний элемент второго уровня"
}
}
}
},
{
"id": 101,
"field_type": "date",
"field_value": "01.01.2027"
},
{
"id": 102,
"field_type": "time",
"field_value": "09:00"
},
{
"id": 103,
"field_type": "regex",
"field_value": "example@mail.com"
},
{
"id": 104,
"field_type": "checkbox",
"field_value": 1
},
{
"id": 105,
"field_type": "button",
"field_value": 1
},
{
"id": 105,
"field_type": "multi_button",
"field_value": {
"id": 45928,
"name": {
"ru": "Значение кнопки с ID 45928"
}
}
}
],
"tags": [
"1",
"2"
],
"jira_issues": []
}
}