---
title: "Add an item to an Inventory Order"
method: POST
path: "/inventory/orders/{orderId}/items"
tags: ["InventoryOrders"]
---

# Add an item to an Inventory Order

`POST /inventory/orders/{orderId}/items`

This endpoint adds an item to an inventory order.

## Request body

- object
  - `product_id` string, uuid, required — Identifier of the inventory product to add as a line item. The product must belong to the same site as the order's `site_id` and must be linked to the order's supplier.
  - `quantity` integer, required — The quantity of the inventory product being ordered.
  - `unit_price` integer, required — The unit price of the inventory product in the lowest denomination for the product's currency.

## Response `201`

The inventory order item was successfully retrieved

- object
  - `data` InventoryOrderItem, required
    - `id` string, uuid, required — The ID of the inventory order item.
    - `order_id` string, uuid, required — The ID of the inventory order the item belongs to.
    - `quantity` integer, required — The quantity of the item to be ordered.
    - `unit_price` integer, required — The unit price of the item in the lowest denomination for the product's currency.
    - `product_id` string, uuid, required — The ID of the inventory product to be ordered.
    - `product_name` string, required — The name of the inventory product to be ordered.
    - `line_total` integer, required — The total price of the item in the lowest denomination for the supplier's currency.

## Other responses

- `401` — The user is unauthenticated
- `403` — The authenticated user does not have permission.
- `404` — The resource couldn't be found
- `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)