Создает покупателя.

```
v1/customers/add.php
```

## Параметры

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| name | string | Да | Наименование юрлица или имя ИП и физлица |
| type | int | Нет | Тип: 1 юрлицо, 2 ИП, 3 физлицо. По умолчанию 3 |
| email | string | Нет | Электронная почта |
| phone | string | Нет | Телефон |
| address_legal | string | Нет | Юридический адрес |
| address_real | string | Нет | Адрес доставки |
| inn | string | Нет | ИНН |
| kpp | string | Нет | КПП |
| ogrn | string | Нет | ОГРН |
| agreement | string | Нет | Договор |
| manager_name | string | Нет | Руководитель |
| manager_post | string | Нет | Должность руководителя |
| notes | string | Нет | Заметки |

Формат реквизитов и уникальность имени не проверяются: повторный запрос с тем же именем создаст еще одного покупателя. Подробнее о типах и реквизитах в статье [Покупатели](https://developers.controlata.ru/hc/api-docs/articles/customers).

Покупателя можно создать и вместе с заказом, см. [v1/orders/add](https://developers.controlata.ru/hc/api-docs/articles/orders-add).

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

```
{
    "name": "ООО Мебельный двор",
    "type": 1,
    "email": "zakaz@mebdvor.ru",
    "phone": "+7 495 123-45-67",
    "address_legal": "г. Москва, ул. Лесная, д. 5",
    "address_real": "г. Москва, ул. Складская, д. 12",
    "inn": "7701234567",
    "kpp": "770101001",
    "ogrn": "1027700123456",
    "agreement": "№ 15 от 10.01.2026",
    "manager_name": "Иванов Петр Сергеевич",
    "manager_post": "Генеральный директор"
}
```

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

```
{
    "success": true,
    "customer_id": 512
}
```

## Ошибки

| Ошибка | Причина |
|---|---|
| No name in input | Не передан name или передан null |
| Name must not be empty | Пустое имя |
| Name must be a string | В name передан массив или объект |
| Invalid type value. Must be one of: 1, 2, 3 | Неверный тип |