06.04.2026 22:45

Add

[POST] .../v1/lead/add

Создает CRM-обращение (Lead).

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

Название Тип данных Обязательность Описание
client_id Int64 Необязательный ID клиента в CRM
ticket_id Int64 Необязательный ID тикета-источника (информационная ссылка)
chat_id String(36) Необязательный UUID существующего чата, который нужно привязать к лиду
pipeline_id Int64 Необязательный ID воронки; если не передан, используется воронка по умолчанию для Lead
stage_id Int64 Необязательный ID стадии; если не передан, используется стартовая стадия воронки
responsible_user_id Int64 Необязательный ID ответственного пользователя
participant_user_ids Array of Int64 Необязательный Участники обращения
title String Необязательный Тема обращения
description String Необязательный Описание обращения
amount Decimal Необязательный Сумма обращения
fields Array of FieldValueAdd Необязательный Значения дополнительных полей

Канал для лида определяется сервером автоматически:

  • из ticket_id (если передан);
  • иначе используется первый активный CRM-канал.

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

{
  "client_id": 501,
  "ticket_id": 9001,
  "title": "Заявка с сайта",
  "description": "Клиент просит перезвонить после 15:00",
  "amount": 2500.00,
  "chat_id": "3e73d8f2-66be-4d5a-a35d-03f7dc61a4a9",
  "responsible_user_id": 15,
  "participant_user_ids": [18],
  "fields": []
}

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

Название Тип данных Описание
result.new_id Int64 ID созданного обращения

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

{
  "ok": true,
  "result": {
    "new_id": 105
  }
}

Пример ошибки

{
  "ok": false,
  "result": {
    "error": 1002,
    "description": "channel_id"
  }
}