Webhooks

ShipyBox sends webhook events to your registered URL whenever a relevant change happens to a shipment.

Configure

Dashboard → Settings → Webhooks — register up to 5 URLs.

Event types

Event	Description
`shipment.created`	A new shipment was booked
`shipment.picked_up`	Courier picked up the parcel
`shipment.in_transit`	Parcel is moving
`shipment.out_for_delivery`	Parcel is with the delivery agent
`shipment.delivered`	Parcel delivered
`shipment.rto_initiated`	Return to origin started
`shipment.ndr_raised`	Non-delivery report raised
`cod.remitted`	COD amount remitted to your bank
`weight.reconciled`	Weight reconciliation outcome

Payload example

{
  "event": "shipment.delivered",
  "occurred_at": "2026-01-12T16:42:00+05:30",
  "awb": "SBX78234112",
  "order_id": "ORD-9981",
  "data": { "courier": "Delhivery", "signed_by": "Rohan" }
}

Security

Every payload is signed with X-ShipyBox-Signature: sha256=<hex>. Verify it using your webhook secret.