post
https://api.spreetail.com/api/v0/root-purchase-orders
Creates a new root purchase order as a draft. Nothing is sent to Spreetail until you call Submit Root Purchase Order, so you can keep editing the draft. You can include purchase orders now or add them later.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Example
{
"orderType": "domestic",
"transportationTerms": "Collect - Variable",
"shipPointId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"purchaseOrders": [
{
"warehouseId": 25,
"earliestShipDate": "2026-12-01T00:00:00Z",
"lineItems": [
{ "partNumber": "ABC-123", "quantity": 500 }
]
}
]
}Supplier
Every root purchase order belongs to one supplier.
- If your brand has one supplier, leave
supplierIdout and it's filled in for you. - If your brand has more than one,
supplierIdis required. Leaving it out returns400. Use List Suppliers to see your supplier IDs.
The supplier can't be changed after the draft is created. To use a different supplier, create a new draft.
Transportation terms
| Order type | Allowed values |
|---|---|
domestic | Collect - Variable, Prepaid - Vendor builds freight into cost. |
import | DDP - Delivery Duty Paid (Prepaid), DDPp - Delivery Duty Paid (Port), mDDP - Modified Delivery Duty Paid (Collect) |