Добавление
Добавление новой задачи
POST https://do.freshoffice.ru/task/insert
Request Body
| Name | Type | Description |
|---|---|---|
| task* | JSON |
200: OK Стандартный объект ответа
{
"status": "success",
"error": "",
"code": null,
"rows": 0,
"pages": 0,
"page": 0,
"value": "5001"
}
JSON
Все доступные параметры нового объекта
- company_id - * Код контрагента
- note - * Текст задачи
- type_id - * Код вида задачи:
GET /directory/35 - user_id - Код исполнителя. По умолчанию — владелец токена
- status_id - Статус: 1 — в работе (по умолчанию), 2 — выполнена
- deal_id - Код сделки, к которой привязана задача
- contact_id - Код контактного лица
- date_start - Дата/время начала, например 2026-08-27 15:00. По умолчанию — сейчас
- date_finish - Дата/время завершения
- is_hot - 1 — срочная задача
- reminder_minutes - За сколько минут напомнить исполнителю
- tags - Теги через запятую
{
"company_id": 368132,
"note": "Позвонить клиенту и согласовать условия поставки",
"type_id": 1,
"user_id": 37,
"date_start": "2026-08-27 15:00",
"date_finish": "2026-08-27 16:00",
"reminder_minutes": 30
}
Примечание
Обязательные параметры
company_id (Код контрагента)
note (Текст задачи)
type_id (Код вида задачи — список видов: GET /directory/35)
Назначившим задачу (assigned by) автоматически становится владелец токена.
Пример
cURL
NodeJS (Request)
curl --location --request POST 'https://do.freshoffice.ru/task/insert' \
--header 'Authorization: Bearer XXXX-XXXXXXX-XXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '{
"company_id": 368132,
"note": "Позвонить клиенту и согласовать условия поставки",
"user_id": 37,
"date_start": "2026-08-27 15:00"
}
'
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://do.freshoffice.ru/task/insert',
'headers': {
'Authorization': 'Bearer XXXX-XXXXXXX-XXXXXXX',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"company_id": 368132,
"note": "Позвонить клиенту и согласовать условия поставки",
"user_id": 37,
"date_start": "2026-08-27 15:00"
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Справочники
Ответ
{
"status": "success",
"error": "",
"code": null,
"rows": 0,
"pages": 0,
"page": 0,
"value": "5001"
}
// value - ID идентификатор новой задачи
Предыдущая
Следующая