POST /clients — новый клиент

Заводит карточку клиента. Если клиент с такой почтой или телефоном уже есть, новая не создаётся — придёт его id. Право — clients:write.

Запрос

curl https://app.deskus.ru/api/v1/clients \
  -H "Authorization: Bearer $DESKUS_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: crm-contact-5531" \
  -d '{ "name": "Мария Котова", "email": "maria@example.com", "phone": "+7 900 123-45-67", "city": "Казань" }'

Ответ 201

{
  "data": {
    "id": "5f1a9e7c-2b3d-4e8f-a0c1-7d6b5e4f3a21",
    "name": "Мария Котова",
    "email": "maria@example.com",
    "phone": "+79001234567",
    "company": null,
    "city": "Казань",
    "is_vip": false,
    "created_at": "2026-10-21T09:15:04.102Z",
    "updated_at": "2026-10-21T09:15:04.102Z"
  }
}

Дубль

Ответ 409

{
  "error": {
    "code": "conflict",
    "message": "Такой клиент уже есть: Мария Котова",
    "details": { "existing_client_id": "5f1a9e7c-2b3d-4e8f-a0c1-7d6b5e4f3a21", "matched_by": "email" },
    "request_id": "req_3f9c2a7d1e6b4a8c0d2e5f71"
  }
}

Возьмите existing_client_id и работайте с найденной карточкой. Карточка создаётся с источником «через API» — так её видно в истории клиента.

Другие ошибки: 422 validation_error — нет имени, почта не похожа на адрес, в телефоне мало цифр; поле — в details.field.