Новая сделка На данный момент через API к сделке можно привязать только контакт.

Метод для создания новой сделки в вашей компании.

При создании сделки обязательным условием является заполнение названия сделки, указание идентификатора контакта и этапа воронки продаж. Создать новый контакт вы можете в методе новый контакт, а получить актуальный список этапов в методе список воронок и этапов продаж.

Вы можете заполнять дополнительные поля сделки, которые созданы в вашей компании. Получить актуальный список идентификаторов дополнительных полей сделки вы можете в методе Список дополнительных полей.

post /deals создание новой сделки
Запрос
deal object* Собранный объект параметров создаваемой сделки
name string* Название сделки
client_id integer* Идентификатор контакта, привязываемого к сделке
stage_id integer* Идентификатор этапа воронки продаж, привязываемого к сделке
cost integer Стоимость сделки в рублях (по умолчанию 0)
custom_properties array of objects Задаваемые дополнительные поля
id integer Идентификатор дополнительного поля сделки
value string Устанавливаемое значение
note object Объект создаваемой заметки к сделке
content string Текст заметки
Ответ
data object Созданная сделка
id integer Идентификатор созданной сделки
owner_id integer Идентификатор сотрудника, создавшего сделку
created_at string Дата и время создания сделки (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
name string Название сделки
client_id integer Идентификатор контакта, привязанного к сделке
stage_id integer Идентификатор этапа воронки продаж, привязанного к сделке
cost integer Стоимость сделки в рублях
state string Состояние сделки (для активной сделки working)
custom_properties array of objects Дополнительные поля созданной сделки
id integer Идентификатор поля
name string Название поля
data_type string Тип поля (string, number или date)
value string Значение
Возможные ошибки запроса (errors code)
blank Обязательное поле (не может быть пустым)
too_long Слишком длинное значение (пояснения вы получите в поле message)
not_a_number Поле не является числом (например, вы прислали стоимость сделки не числом)
not_found Не удалось найти
invalid Поле имеет неверное значение
{
  "deal": {
    "name": "Заказ #22",
    "client_id": 3609,
    "stage_id": 1034,
    "cost": 1800,
    "note": {
      "content": "Красная шапка, 50 см, осенняя"
    },
    "custom_properties": [
      {
        "id": 1123,
        "value": 500
      }
    ]
  }
}
{
  "data": {
    "id": 2345,
    "owner_id": 226,
    "created_at": "2020-04-22T12:32:29.000Z",
    "name": "Заказ #22",
    "client_id": 3609,
    "stage_id": 1034,
    "cost": 1800,
    "state": "working",
    "custom_properties": [
      {
        "id": 1123,
        "name": "Предоплата",
        "data_type": "number",
        "value": 500
      }
    ]
  }
}