---
title: "Create an Inventory Brand"
method: POST
path: "/inventory/brands"
tags: ["InventoryBrands"]
---

# Create an Inventory Brand

`POST /inventory/brands`

This endpoint creates an inventory brand for the given organisation.

## Request body

- object
  - `site_id` string, uuid, required — Identifier of the site that owns this inventory brand. Brands are scoped per site, so the API key must have access to this site. Must belong to the supplied `organisation_id`.
  - `organisation_id` string, uuid, required — Identifier of the organisation this brand sits under. Used for cross-site reporting and to enforce that the referenced `site_id` belongs to the same organisation.
  - `name` string, required — Human-readable name of the inventory brand, shown in the inventory admin UI and on supplier order forms. Trimmed; must be 1-120 characters and not contain HTML.

## Response `201`

The inventory brand was successfully retrieved

- object
  - `data` InventoryBrand, required
    - `id` string, uuid, required — The ID of the inventory brand.
    - `name` string, required — The name of the inventory brand.
    - `site_id` string, uuid, nullable, required — The ID of the site the inventory brand belongs to.
    - `organisation_id` string, uuid, required — The ID of the organisation the inventory brand 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)