Orders
Create Fulfillment
Create a fulfillment for the order’s items.
POST
/
vendor
/
orders
/
{id}
/
fulfillments
curl -X POST 'http://localhost:9000/vendor/orders/order_01HXYZABCDEF/fulfillments' \
-H 'Authorization: Bearer <token>' \
-H 'x-seller-id: <seller_id>' \
-H 'Content-Type: application/json' \
-d '{
"items": [{ "id": "ordli_01HXYZABCDEF", "quantity": 1 }],
"requires_shipping": true,
"location_id": "sloc_01HXYZABCDEF"
}'
const { fulfillment } = await client.vendor.orders.$id.fulfillments.mutate({
$id: "order_01HXYZABCDEF",
items: [{ id: "ordli_01HXYZABCDEF", quantity: 1 }],
requires_shipping: true,
location_id: "sloc_01HXYZABCDEF",
})
{
"fulfillment": {
"id": "ful_01HXYZABCDEF",
"location_id": "sloc_01HXYZABCDEF",
"requires_shipping": true,
"packed_at": "2026-06-03T10:00:00.000Z",
"shipped_at": null,
"delivered_at": null,
"created_at": "2026-06-03T10:00:00.000Z"
}
}
Creates a fulfillment for the specified items from a stock location owned by the seller.
Path parameters
string
required
The order’s ID.
Body parameters
object[]
required
boolean
required
Whether the fulfillment requires shipping.
string
required
ID of the stock location to fulfill from.
Response
object
curl -X POST 'http://localhost:9000/vendor/orders/order_01HXYZABCDEF/fulfillments' \
-H 'Authorization: Bearer <token>' \
-H 'x-seller-id: <seller_id>' \
-H 'Content-Type: application/json' \
-d '{
"items": [{ "id": "ordli_01HXYZABCDEF", "quantity": 1 }],
"requires_shipping": true,
"location_id": "sloc_01HXYZABCDEF"
}'
const { fulfillment } = await client.vendor.orders.$id.fulfillments.mutate({
$id: "order_01HXYZABCDEF",
items: [{ id: "ordli_01HXYZABCDEF", quantity: 1 }],
requires_shipping: true,
location_id: "sloc_01HXYZABCDEF",
})
{
"fulfillment": {
"id": "ful_01HXYZABCDEF",
"location_id": "sloc_01HXYZABCDEF",
"requires_shipping": true,
"packed_at": "2026-06-03T10:00:00.000Z",
"shipped_at": null,
"delivered_at": null,
"created_at": "2026-06-03T10:00:00.000Z"
}
}
⌘I
curl -X POST 'http://localhost:9000/vendor/orders/order_01HXYZABCDEF/fulfillments' \
-H 'Authorization: Bearer <token>' \
-H 'x-seller-id: <seller_id>' \
-H 'Content-Type: application/json' \
-d '{
"items": [{ "id": "ordli_01HXYZABCDEF", "quantity": 1 }],
"requires_shipping": true,
"location_id": "sloc_01HXYZABCDEF"
}'
const { fulfillment } = await client.vendor.orders.$id.fulfillments.mutate({
$id: "order_01HXYZABCDEF",
items: [{ id: "ordli_01HXYZABCDEF", quantity: 1 }],
requires_shipping: true,
location_id: "sloc_01HXYZABCDEF",
})
{
"fulfillment": {
"id": "ful_01HXYZABCDEF",
"location_id": "sloc_01HXYZABCDEF",
"requires_shipping": true,
"packed_at": "2026-06-03T10:00:00.000Z",
"shipped_at": null,
"delivered_at": null,
"created_at": "2026-06-03T10:00:00.000Z"
}
}