# order.shipment.updated

The shipment of an order changed, whoever handles it: a delivery app, the merchant or Larm shipping.

Scope: `orders:read`

The envelope `resource.type` is `order`, and `delivery.source` says who handles the shipment. Your own updates come back to you too, so compare with what you hold. Use it to follow a tracking number and to tell the customer. See [Delivery companies](/guides/delivery-companies).

## Payload `data`

| Field | Type | Required | Description |
|---|---|---|---|
| `order_id` | string | no | Order ID. |
| `number` | integer | no | Display order number. |
| `delivery` | object | no | source, app_id, option_id, label, carrier, status, tracking_number, tracking_url and updated_at. |


## Example delivery

```http
POST /larm/webhooks HTTP/1.1
Host: app.example.com
Content-Type: application/json
x-larm-event: order.shipment.updated
x-larm-event-id: 0b7c2f8e-1d3a-4c5b-9e6f-7a8b9c0d1e2f
x-larm-delivery: 2b9f6c1e-8d4a-4f30-a7e5-c1d9b8a7f604
x-larm-timestamp: 1792060982
x-larm-secret-generation: 1
x-larm-payload-version: 1
x-larm-signature: v1=5d41402abc4b2a76b9719d911017c592e1c7b0d3f6a8e2b4c9d0f1a2b3c4d5e6
```

```json
{
  "app_id": "1f2e3d4c-5b6a-4978-8695-a4b3c2d1e0f9",
  "data": {
    "order_id": "200123",
    "number": 200123,
    "delivery": {
      "source": "app",
      "app_id": "1f2e3d4c-5b6a-4978-8695-a4b3c2d1e0f9",
      "option_id": "one-hour",
      "label": "Delivery within an hour",
      "carrier": "Fast Courier",
      "status": "out_for_delivery",
      "tracking_number": "FC-20145",
      "tracking_url": "https://track.example.com/FC-20145",
      "updated_at": "2026-11-02T10:04:00.000Z"
    }
  },
  "id": "0b7c2f8e-1d3a-4c5b-9e6f-7a8b9c0d1e2f",
  "installation_generation": 1,
  "installation_id": "c7e4a1f2-6b3d-4e8a-9c05-1d2f3a4b5c6d",
  "occurred_at": "2026-10-15T09:13:02Z",
  "payload_version": 1,
  "resource": {
    "type": "order",
    "id": "200123",
    "version": 6
  },
  "store_id": "5b1d7a62-0c4e-4f38-9a51-2e7b3c9d8f10",
  "test": false,
  "type": "order.shipment.updated"
}
```