DEVELOPERS
Subscribe to lifecycle events across orders, shipments, tracking, and returns. Carriyo pushes structured payloads to your endpoints the moment something happens - no polling required.
View API ReferenceEVENT TYPES
Carriyo emits events across the entire post-checkout lifecycle. Subscribe to specific events or entire categories.
order.created, order.updated, order.allocated, order.cancelled.
Track the full order lifecycle from creation to completion.
shipment.created, shipment.booked, shipment.label_generated, shipment.dispatched.
Know the moment a shipment moves.
tracking.updated, tracking.delivered, tracking.exception, tracking.returned_to_origin.
Real-time delivery status changes.
return.requested, return.approved, return.picked_up, return.received.
Stay informed throughout the reverse logistics flow.
RELIABILITY
Failed deliveries are retried with exponential backoff up to 24 hours.
HMAC-SHA256 signatures on every payload so you can verify authenticity.
Sequence numbers ensure you can process events in the correct order.
Full audit trail of every webhook delivery attempt, response, and retry.
Subscribe to specific event types, statuses, or entity filters to reduce noise.
Re-deliver any event from the last 30 days for debugging or recovery.
GETTING STARTED
Add your HTTPS endpoint URL in the Carriyo dashboard or via API. Configure which events you want to receive.
Use the shared secret to validate HMAC signatures on incoming payloads. Reject anything that doesn't match.
Handle the event payload, return a 2xx response within 30 seconds, and you're done. Carriyo handles the rest.