Creating a Supplier | Controlata API Documentation

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.

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