Add Item to Purchase Order | Ply

Adds a new line item to a purchase order. Returns 201 Created.

Requires scope: purchase_orders:write

Authentication

API_KEYstring

API Key authentication via header

Path parameters

idUUIDRequired

Purchase order ID.

Request

This endpoint expects an object.

materialIdUUIDRequired

ID of the material to add. Required.

quantitydoubleRequired

Quantity to order. Required. Must be greater than zero.

pricedoubleRequired

Cost per unit in USD. Required. Must be greater than or equal to zero.

materialVariationIdUUIDOptional

ID of the material variation, if applicable.

notestringOptional

Optional note for this line item.

Response

This endpoint returns an object.

idUUID

Unique identifier for this line item.

quantitydouble

Ordered quantity.

pricedouble

Cost per unit in USD.

materialobject

Reference to the material being ordered.

variationobject

Reference to the material variation, if applicable.

notestring

Optional note for this line item.

createdAtdatetime

ISO 8601 timestamp when the item was created.

updatedAtdatetime

ISO 8601 timestamp when the item was last updated.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

$	curl -X POST https://api.getply.com/api/v1/purchase-orders/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items \
>	-H "API_KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"materialId": "e5f6a7b8-c9d0-1234-efab-345678901234",
>	"quantity": 50,
>	"price": 25
>	}'

1	{
2	"id": "d4e5f6a7-b8c9-0123-defa-234567890123",
3	"quantity": 50,
4	"price": 25,
5	"material": {
6	"id": "e5f6a7b8-c9d0-1234-efab-345678901234",
7	"name": "3/4 inch PVC Pipe (10ft)"
8	},
9	"variation": null,
10	"note": null,
11	"createdAt": "2026-03-20T14:30:00Z",
12	"updatedAt": "2026-03-20T14:30:00Z"
13	}