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"
}
}
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
The order’s ID.
Body parameters
Whether the fulfillment requires shipping.
ID of the stock location to fulfill from.
Response
Show properties
Show properties
The fulfillment’s ID.
ID of the stock location fulfilled from.
Whether the fulfillment requires shipping.
When the fulfillment was packed.
When the fulfillment was shipped.
When the fulfillment was delivered.
Creation timestamp.
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