Sign in
Events/Logistics
shipment.exception

Shipment exception

Delivery hit an exception (failed pickup, customer unreachable, returned to sender).

When this fires

Fires whenever the underlying state change happens on the platform.

Sample payload

This is the exact envelope shape we POST to your endpoint — outer wrapper plus the per-event data payload. Field values are randomised on each render so you see the general shape, not a fixed example.

json
{
  "id": "ed684a9a-e1a1-4791-8d64-5291203df4f7",
  "event": "shipment.exception",
  "created": "2026-06-12T15:00:35.601Z",
  "data": {
    "shipmentId": "c2k62qm8r2h20000000000000",
    "merchantReference": "PHR-4193",
    "carrier": "chowdeck",
    "exceptionCode": "customer_unreachable",
    "exceptionMessage": "Parcel rejected by recipient.",
    "dropoffAddress": "Aminu Kano Crescent, Wuse 2, Abuja",
    "occurredAt": "2026-06-12T15:00:35.601Z"
  }
}

Use cases

  • Trigger any downstream automation that cares about this state change.
  • Mirror the event into your data warehouse for analytics.
  • Notify a human channel for high-signal events.

Subscribe in the dashboard

To start receiving this event, add it to a webhook's subscription list in Developers → Webhooks. Wildcard subscriptions ( shipment.*) work too — see the webhooks guide for the matching rules.