Real-Time Shipment
Webhooks

Get instant push notifications for every shipment and carrier event — delivered to your server the moment it happens. No polling. No delays.

shipment.delivered payload

{
  "event": "shipment.delivered",
  "timestamp": "2025-11-14T10:32:00Z",
  "version": "v1",
  "data": {
    "awb": "QX1234567890",
    "order_id": "ORD-98765",
    "courier": "Delhivery",
    "status": "DELIVERED",
    "delivered_at": "2025-11-14T10:30:00Z",
    "location": "Mumbai, MH",
    "proof_of_delivery": {
      "type": "OTP",
      "verified": true
    },
    "recipient": {
      "name": "Rahul Sharma",
      "pincode": "400001"
    }
  }
}

Get Started in 4 Steps

Register Endpoint

Add your HTTPS endpoint URL in the QUIXGO dashboard under Settings → Webhooks.

Select Events

Choose which shipment and carrier events should trigger a POST to your endpoint.

Verify Signature

Validate incoming payloads using the HMAC-SHA256 signature in the X-Quixgo-Signature header.

Go Live

Respond with HTTP 200 and QUIXGO delivers events in real time — no polling needed.

Shipment Events

Subscribe to the full shipment lifecycle — from booking to delivery or return

shipment.created

Fires when a new shipment is booked and AWB is generated.

shipment.picked_up

Fires when the courier executive picks up the parcel.

shipment.in_transit

Fires at each scan event as the parcel moves through hubs.

shipment.out_for_delivery

Fires when the parcel reaches the last-mile delivery agent.

shipment.delivered

Fires on successful delivery with timestamp and POD details.

shipment.exception

Fires on delivery failure, address issues, or customer unavailability.

shipment.rto_initiated

Fires when a Return-to-Origin is triggered after failed delivery.

shipment.rto_delivered

Fires when the returned parcel reaches the seller's warehouse.

Carrier & Operations Events

Stay informed about NDRs, COD remittances, manifests, and SLA breaches

carrier.ndr_raised

Non-delivery report raised by the courier partner.

carrier.cod_remitted

COD amount remitted to your bank account.

carrier.manifest_generated

Manifest file ready for handover to the courier.

carrier.sla_breached

Shipment has exceeded the committed delivery SLA.

Built for Reliability

Our webhook infrastructure is designed to never miss an event

Real-Time Delivery

Events delivered within seconds of the status change — no polling lag.

Signed Payloads

Every request carries an HMAC-SHA256 signature so you can verify authenticity.

Auto Retry

Failed deliveries are retried up to 5 times with exponential back-off.

Structured JSON

Clean, versioned JSON payloads with a consistent schema across all events.

Event Filtering

Subscribe only to the events you need — reduce noise in your system.

Delivery Logs

Full log of every webhook attempt with status, response code, and latency.

What You Can Build

Webhooks unlock powerful automation across your logistics stack

Customer Notifications

Send WhatsApp, SMS, or email updates to customers at every delivery milestone automatically.

Order Management Sync

Instantly update your OMS or ERP when orders are delivered or returned.

NDR Auto-Resolution

Trigger re-attempt workflows or customer calls the moment a delivery fails.

COD Reconciliation

Reconcile COD remittances automatically in your accounting system.

SLA Alerting

Page your ops team or escalate with the carrier when SLA breach events fire.

Analytics & Reporting

Stream shipment events into your data warehouse for real-time delivery dashboards.

Real-Time ShipmentWebhooks