Delivery status changed

Webhook

POST

delivery.status_changed

Delivery progress for external couriers (Stuart, Wolt Drive, Stava, Diament Delivery) and your own drivers, normalized to one vocabulary. Statuses only move forward; nothing is sent after a final one.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200OK

Return any 2xx to acknowledge. Anything else is retried after 10 s, 1 min and 5 min; after 20 failed deliveries in a row the webhook is disabled in the panel.

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data '{
    "event": "delivery.status_changed",
    "id": "94ed75f8-7286-43e8-b30b-5a65d9e16d9a",
    "created_at": "2026-09-12T09:15:45+02:00",
    "company_uid": "1623978b-9ac9-400a-b6a0-2b7b8f97bb64",
    "data": {
        "order": {
            "uid": "3f1b1f0c-2c2e-4c42-9f1a-6b5a4d2e8a11",
            "number": "#1024",
            "restaurant_uid": "b06a191d-8e22-4707-8c1e-9b5119cf4461"
        },
        "occurred_at": "2026-09-12T09:15:45+02:00",
        "delivery": {
            "provider": "stuart",
            "uid": "b9d1c0f2-1a2b-4c3d-9e8f-7a6b5c4d3e2f",
            "external_id": "STU-88213",
            "provider_status": "PACKAGE_DELIVERING",
            "tracking_url": "https://tracking.stuart.com/STU-88213",
            "courier_phone": "+48500100200",
            "status": "PICKED_UP",
            "previous_status": "ASSIGNED"
        }
    }
}'

Modified at 2026-09-12 07:42:55

Client points changed

Order status changed