---
title: "Create a purchase order item"
method: POST
path: "/ext/v2/purchase-order-items/"
tags: ["Inventory"]
---

# Create a purchase order item

`POST /ext/v2/purchase-order-items/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/purchase-order-items/`
- Auth: HTTP bearer

This endpoint is available to Group API Keys only.

Creates a new line item on an existing draft purchase order.

A **purchase order item** is a single line item on a purchase order, identifying the inventory being ordered, the quantity, and the price. The quantity specified in the payload is expected to be in the same unit of measure as the configured unit of measure for the inventory code.

## Request body

- PurchaseOrderItemStandaloneCreateSchema
  - `inventory_id` integer, nullable: The inventory id identifying the item to order. Must provide exactly one of inventory_shortcode or inventory_id, not both
  - `inventory_shortcode` string, nullable: The inventory shortcode (human-readable code) identifying the item to order. Must provide exactly one of inventory_shortcode or inventory_id, not both. Inventory shortcodes are deprecated for new integrations; supported during a deprecation window for existing callers.
  - `purchase_order_id` integer, required: The ID of the purchase order to add this item to
  - `quantity` union, required: The quantity to order (must be greater than 0)
    - number
    - string
  - `sku` string: An optional SKU identifier for this item
  - `total_price` integer: The total price for this line item, in cents

## Response `201`

Created

- ExternalPurchaseOrderItemSchema
  - `created` string, date-time, required: The datetime this object was created.
  - `id` integer, required: The unique identifier for the purchase order item
  - `inventory_id` integer, nullable, required: The inventory id for this item
  - `inventory_shortcode` string: The inventory shortcode (human-readable code) for this item
  - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
  - `quantity` union, required: The quantity ordered
    - number
    - string
  - `sku` string, required: The SKU identifier for this item
  - `total_price` integer, required: The total price for this line item, in cents
  - `unit_of_measure` string, required: The unit of measure for this item

---

[API](https://skmtc.dev/vetcove/apis/ninjaapi.md) - [All operations](https://skmtc.dev/vetcove/apis/ninjaapi/llms.txt) - [OpenAPI document](https://skmtc.dev/vetcove/apis/ninjaapi/revisions/4ceaed956e15?raw)