Skip to main content
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"
  }'
{
  "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

id
string
required
The order’s ID.

Body parameters

items
object[]
required
Items to fulfill.
requires_shipping
boolean
required
Whether the fulfillment requires shipping.
location_id
string
required
ID of the stock location to fulfill from.

Response

fulfillment
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"
  }'
{
  "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"
  }
}