Webhooks

Subscribe to events so your systems react as orders and shipments change, instead of polling.

Events

Common event types include:

Event	Fires when
order.created	A new order syncs in from a bridge
order.updated	An order's status or fields change
shipment.created	A shipment/label is created
shipment.tracking_updated	A tracking event arrives from a carrier

Delivery

Orderly POSTs a JSON payload to your endpoint. Verify authenticity with the signature header before trusting a payload, and respond 2xx quickly. Non-2xx responses are retried with backoff.

{
  "event": "order.created",
  "organization_id": "…",
  "data": { "id": "…", "order_number": "1001", "status": "pending" },
  "created_at": "2026-07-23T12:00:00Z"
}

See the Webhooks reference for managing subscriptions.