Creates a supplier.

```
v1/suppliers/add.php
```

## Parameters

| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Name |
| email | string | No | Email |
| phone | string | No | Phone |
| address | string | No | Address |
| agreement | string | No | Agreement |
| manager_name | string | No | Manager |
| manager_post | string | No | Manager's position |
| notes | string | No | Notes |

A supplier can also be created together with a purchase, see [v1/purchases/add](https://developers.controlata.com/hc/api-docs/articles/api-purchases-add).

## Example request

```
{
    "name": "Woodtrade Ltd",
    "email": "sales@woodtrade.com",
    "phone": "+1 646 555-0188",
    "address": "8 Harbor St, Boston",
    "agreement": "No. 7 of 15 Feb 2026",
    "manager_name": "Oleg Baker",
    "manager_post": "Director"
}
```

## Example response

```
{
    "success": true,
    "supplier_id": 45
}
```

## Errors

| Error | Reason |
|---|---|
| No name in input | name is missing or null |
| Name must not be empty | Empty name |
| Name must be a string | name passed as an array or object |