---
title: "Create a Supplier"
method: POST
path: "/inventory/suppliers"
tags: ["Suppliers"]
---

# Create a Supplier

`POST /inventory/suppliers`

This endpoint creates a supplier for the given organisation.

## Request body

- object
  - `name` string, required — Trading name of the inventory supplier, shown on purchase orders and supplier reports. Trimmed; 1-120 characters, must not contain HTML.
  - `site_id` string, uuid, required — Identifier of the site that owns this supplier record. Supplier records are scoped per site so each site can maintain its own supplier list, terms, and contact info.

## Response `201`

The supplier was successfully retrieved

- object
  - `data` Supplier, required
    - `id` string, uuid, required — The ID of the supplier.
    - `name` string, required — The name of the supplier.
    - `email` string, nullable, required — An email address for the supplier.
    - `phone` string, nullable, required — A phone number for the supplier.
    - `address_1` string, nullable, required — The first line of the supplier's address.
    - `address_2` string, nullable, required — The second line of the supplier's address.
    - `city` string, nullable, required — The city part of the supplier's address.
    - `county` string, nullable, required — The county part of the supplier's address.
    - `country` string, nullable, required — The country part of the supplier's address.
    - `postcode` string, nullable, required — The ZIP or postal code part of the supplier's address.
    - `site_id` string, uuid, required — The ID of the site this supplier record belongs to.
    - `organisation_id` string, uuid, required — The ID of the organisation this supplier record belongs to.

## Other responses

- `401` — The user is unauthenticated
- `403` — The authenticated user does not have permission.
- `422` — The request didn't pass validation

---

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