12.03.2026 20:40

Add

[POST] .../v1/deal/add

Создает CRM-сделку.

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

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

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

{
  "source_lead_id": 105,
  "ticket_id": 9001,
  "client_id": 501,
  "task_id": 845,
  "lead_id": 105,
  "title": "Сделка по заявке #105",
  "amount": 2500.00,
  "currency_id": 1,
  "chat_id": "d53ec2aa-b1ea-4234-8e1f-8fd4d2f9f7f0",
  "responsible_user_id": 15,
  "participant_user_ids": [18],
  "fields": []
}

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

Название Тип данных Описание
result.new_id Int64 ID созданной сделки

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

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