Notification event [Useful for selected webhooks]

In case you want to receive webhooks only for specific events from Clickpost, Clickpost provides functionality for the same.

If you opt for this service (Selected Event Webhooks), we add the "notification_event_id" key in the webhook payload. This will inform you of the current status of the shipment.

Notification Event ID

Notification Event IDDescriptionClickpost Status Code
1Out For Pickup25
2Shipped[4, 5, 18, 19, 20]
3Out For Delivery6
4Failed Delivery[7, 9]
5Delivered8
86RTO-Requested[11, 12]
6RTO[13, 15, 21, 26, 27]
10Order Cancelled10
12RTO-Delivered14
13Reached destination hub1004
14Exchange Pickup[30, 31]
15Exchange Delivered[32]
16Pickup Failed[3]
17Shipment Stuck
18SLA breached
19Lost16
20Damaged17
80Expired23
28Shipped from Origin hub1006

Notification Event: 6 defines that the shipment has been marked as RTO-In-transit by the carrier and in general is considered a flag to initiate refunds.


Following notification_event_id are helpful for customers using Clickpost's managed returns/exchange service, which accepts return requests from the end user:

ValueDescription
9AWB registered: As soon as an AWB is generated in Clickpost
11Return request placed: As soon as a return request is placed by the end user using Clickpost’s return UI
22Return request approved
23Return request rejected
30Exchange request placed: as soon as an exchange request is placed by the end user using Clickpost's return/exchange UI
29Exchange request approved
31Exchange request Rejected

HLD Specific Notification Event IDs

Notification Event IDNotification Event Description
92RiderAllocationFailed
93RiderAllocated
94ReachedPickupLocation
95ReachedDropLocation
139RiderEnteredDropLocationGeofence

HLD Reallocation Specific Notification Event IDs

For sample webhook payloads of these events, refer to Fetch Reallocation Order Details via Webhook

Notification Event IDNotification Event Description
115SHIPMENT_CREATION_SUCCESSFUL
116SHIPMENT_CREATION_FAILED
117CARRIER_ALLOCATED
118CARRIER_ALLOCATED_PROVISIONALLY
134REALLOCATION_ABORTED
146REALLOCATION_PAUSED
147REALLOCATION_UNEXPECTEDLY_ABORTED

Terminal Notification Event IDs

Notification Event IDNotification Event Description
5Delivered
12RTO Delivered
19Lost
20Damaged
10Cancelled

**Important note:

  1. notification_event_ids and clickpost_status_codes are different codes. If you are using subscribing for selected event webhooks, you should apply logic on notification_event_id.
  2. In case you subscribe for all status event webhooks, you should apply logic on clickpost_status_code : https://docs.clickpost.ai/docs/tracking-status-codes

Did this page help you?