order.fulfillment.status_changed

An order fulfillment lifecycle status changed.

stablev1ordersscope: orders:read

Payload

Webhook deliveries use the common event envelope. The event-specific object is available at data.object.

events/public/payloads/order.fulfillment.status_changed.v1.schema.jsonevents/public/examples/order.fulfillment.status_changed.v1.json

data.object fields

Field	Type	Required	Description
`id`	`string \| null`	optional
`object`	`string \| null`	optional
`fulfillment_mode`	`string \| null`	optional	shipping, local_delivery, pickup, online, service, none, None
`shipment_status`	`string`	optional
`previous_shipment_status`

Loading documentation...

Field	Type	Required	Description
`(_id\|^id)$`	`string \| null`	optional
`.*_at$`	`string \| null`	optional	format: date-time

Example

Event body

{
  "api_version": "2026-06-09",
  "created": "2026-06-09T12:00:00Z",
  "data": {
    "object": {
      "event": "order.fulfillment.status_changed",
      "fulfillment_mode": "pickup",
      "id": "ord_example",
      "metadata": {
        "fulfillment": "oful_example"
      },
      "object": "order",
      "shipment_status": "ready_for_pickup",
      "status_label": "Prepared for pickup"
    }
  },
  "environment": "test",
  "id": "wevt_Abcdef1234567890Ghijk",
  "livemode": false,
  "object": "event",
  "type": "order.fulfillment.status_changed"
}

data.object

{
  "event": "order.fulfillment.status_changed",
  "fulfillment_mode": "pickup",
  "id": "ord_example",
  "metadata": {
    "fulfillment": "oful_example"
  },
  "object": "order",
  "shipment_status": "ready_for_pickup",
  "status_label": "Prepared for pickup"
}