---
title: "Створити клієнта/ліда"
method: POST
path: "/clients"
tags: ["Clients"]
---

# Створити клієнта/ліда

`POST /clients`

**Метод створює клієнта/ліда.** <br/>Якщо такий вже існує, то йому буде оновлено дані. <br/>Пошук відбувається за номером телефону та email.

## Query parameters

- `office_hash_id` string

## Request body

- ClientAttributes — Атрибути клієнта/ліда
  - `company` string, required — Назва компанії (якщо не заповнено, то буде взято значення ПІБ клієнта)
  - `person` string — ПІБ клієнта
  - `email` string — Email
  - `phones` string[] — Список телефонів клієнта
  - `lead` boolean — Це лід?
  - `important` boolean — Важливо
  - `comment` string — Коментар
  - `birthday` string — Дата народження
  - `avatar_url` string — URL аватару
  - `contractor_id` number — Ідентифікатор підрядника
  - `source_id` number — Ідентифікатор джерела
  - `status_id` number — Ідентифікатор статусу
  - `main_responsible_id` integer — Ідентифікатор відповідального працівника
  - `section_id` number — Ідентифікатор типу контрагента (користувацькі типи)
  - `tag_names` string[] — Теги
  - `custom_fields` CustomField[]
    - `name` string, required — Назва поля
    - `value` string, required — Значення поля
  - `contacts_attributes` Contact[]
    - `fullname` string, required — ПІБ
    - `email` string — Email
    - `phones` string[] — Список телефонів
    - `custom_fields` CustomField[]
      - `name` string, required — Назва поля
      - `value` string, required — Значення поля

## Response `201`

Успішно створено

- CreatedResponse
  - `id` integer — Ідентифікатор сутності
  - `created_at` string — Дата та час створення
  - `updated_at` string — Дата та час оновлення

## Other responses

- `422` — Помилка валідації

---

[API](https://skmtc.dev/keepincrm/apis/keepincrm-api.md) · [All operations](https://skmtc.dev/keepincrm/apis/keepincrm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keepincrm/keepincrm-api/revisions/d0be1723749a/schema)