16.04.2026 13:25

Add

[POST] .../v1/client/add

Создает клиента CRM.

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

Название Тип данных Обязательность Описание
external_id String Необязательный Внешний ID клиента
name String Необязательный Имя клиента
phone String Необязательный Телефон клиента
email String Необязательный Email клиента
photo_url String Необязательный Ссылка на аватар
description String Необязательный Комментарий
responsible_user_id Int64 Необязательный ID ответственного пользователя
fields Array of FieldValueAdd Необязательный Значения дополнительных полей

Проверки и ограничения

  1. Обязательно должен быть заполнен хотя бы один идентификатор клиента: external_id или phone или email.
  2. Если передан responsible_user_id, пользователь должен существовать.

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

{
  "external_id": "crm-126",
  "name": "Мария Соколова",
  "phone": "+998933334455",
  "email": "m.sokolova@example.com",
  "description": "Клиент из формы сайта",
  "responsible_user_id": 17,
  "fields": []
}

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

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

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

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