---
title: "Create an Inventory Order"
method: POST
path: "/inventory/orders"
tags: ["InventoryOrders"]
---

# Create an Inventory Order

`POST /inventory/orders`

This endpoint creates an inventory order for the given site.

## Request body

- object
  - `purchase_order_number` string, nullable, required — The purchase order number for this inventory order.
  - `supplier_id` string, uuid, required — Identifier of the supplier this order will be sent to. The supplier must belong to the same site as `site_id`; order line items can only reference inventory products that are linked to this supplier.
  - `supplier_email` string, nullable, required — The email address of the supplier for this inventory order.
  - `site_id` string, uuid, required — Identifier of the site this inventory order is placed for. Goods will be received against this site's stock, and only users with access to this site can view or modify the order.

## Response `201`

The inventory order was successfully retrieved

- object
  - `data` InventoryOrder, required
    - `id` string, uuid, required — The ID of the inventory order.
    - `status` 'draft' | 'submitted' | 'received', required — The status of the inventory order.
    - `purchase_order_number` string — The purchase order number for this inventory order.
    - `supplier_id` string, uuid, required — The ID of the supplier for this inventory order.
    - `supplier_name` string, required — The name of the supplier for this inventory order.
    - `supplier_email` string, required — An email address for the supplier of this inventory order.
    - `subtotal` integer, required — The subtotal of the order in the lowest denomination for this order's currency.
    - `currency` string, required — The currency of the inventory order.
    - `item_count` integer, required — The total number of items in the inventory order.
    - `items_added` boolean, required — Whether items have been added to the order.
    - `created_by_id` string, uuid, nullable, required — The ID of the user who created the inventory order.
    - `site_id` string, uuid, required — The ID of the site this inventory order belongs to.
    - `organisation_id` string, uuid, required — The ID of the organisation this inventory order belongs to.
    - `created_at` string, date-time, required — The date and time the inventory order was created.
    - `updated_at` string, date-time, required — The date and time the inventory order was last updated.
    - `submitted_at` string, date-time, nullable, required — The date and time the inventory order was submitted.
    - `last_submitted_at` string, date-time, nullable, required — The date and time the inventory order was last submitted.

## 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)