30.03.2026 18:55

Close

[POST] .../v1/lead/close

Закрывает CRM-обращение.

Входные параметры

Название Тип данных Обязательность Описание
id Int64 Обязательный ID обращения
stage_id Int64 Необязательный Терминальная неуспешная стадия (is_terminal = true, is_success = false)

Если stage_id передан, стадия должна принадлежать воронке обращения и быть терминальной неуспешной.
Успешные терминальные стадии (например won) в Lead/Close запрещены.
Если stage_id не передан, сервер выбирает стадию закрытия автоматически: сначала lost, при отсутствии — первую терминальную неуспешную стадию воронки.

Пример запроса

{
  "id": 105
}

Выходные параметры

Название Тип данных Описание
result.row_affected Int64 Количество измененных строк
result.ids Array of Int64 ID измененных записей

Метод устанавливает status = Closed и дату закрытия end_date.

Пример ответа

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": [105]
  }
}