> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apps.lute.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook Events Catalogue

> Reference catalogue of all outbound webhook events, payload schemas, and triggers.

# Webhook Events Catalogue

All webhook events adhere to the standard Shipdesk JSON event structure:

```json theme={null}
{
  "id": "evt_984920194820",
  "event": "shipment.status",
  "created_at": "2026-11-22T16:40:00.000Z",
  "data": { ... }
}
```

***

## 1. `shipment.status`

Triggered whenever a carrier scan advances an order's status (e.g. `Picked up`, `In transit`, `Out for delivery`).

```json theme={null}
{
  "id": "evt_01h8q7k2v9z4",
  "event": "shipment.status",
  "created_at": "2026-11-22T16:40:00.000Z",
  "data": {
    "orderId": "ORD-2026-9041",
    "awb": "129038102931",
    "carrier": "Delhivery",
    "mode": "Express",
    "previousStatus": "Ready to ship",
    "currentStatus": "In transit",
    "location": "Bengaluru Linehaul Hub",
    "scanTimestamp": "2026-11-22T16:38:12.000Z",
    "edd": "2026-11-25"
  }
}
```

***

## 2. `shipment.delivered`

Triggered immediately when a parcel is confirmed delivered by the carrier executive.

```json theme={null}
{
  "id": "evt_01h8q7k3a1x8",
  "event": "shipment.delivered",
  "created_at": "2026-11-25T11:45:00.000Z",
  "data": {
    "orderId": "ORD-2026-9041",
    "awb": "129038102931",
    "carrier": "Delhivery",
    "deliveredAt": "2026-11-25T11:42:00.000Z",
    "receivedBy": "Customer",
    "location": "Noida, Uttar Pradesh"
  }
}
```

***

## 3. `ndr.raised`

Triggered when a delivery attempt fails in the field and requires merchant intervention.

```json theme={null}
{
  "id": "evt_01h8q7k4c3w2",
  "event": "ndr.raised",
  "created_at": "2026-11-24T15:20:00.000Z",
  "data": {
    "awb": "129038102931",
    "orderId": "ORD-2026-9041",
    "carrier": "Delhivery",
    "customer": "Neha Verma",
    "phone": "9811223344",
    "attempts": 1,
    "reason": "Customer unreachable / phone switched off",
    "actionUrl": "https://apps.lute.co.in/#ndr"
  }
}
```

***

## 4. `pickup.scheduled`

Triggered when carrier pickup is confirmed.

```json theme={null}
{
  "id": "evt_01h8q7k5d7y1",
  "event": "pickup.scheduled",
  "created_at": "2026-11-22T14:00:00.000Z",
  "data": {
    "pickupId": "PKP-2026-801",
    "carrier": "Delhivery",
    "warehouse": "Primary Blr Warehouse",
    "date": "2026-11-23",
    "slot": "10:00 - 13:00",
    "packageCount": 12,
    "carrierReference": "DEL_PU_9849201"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.