This Webhook is only useful for customers using Clickpost’s managed returns platform to accept customer returns on their website
Usecase
This webhook is only useful for customers using Clickpost’s managed returns platform to accept customer returns on their website.
Activating Return Request Webhooks:
Visit Clickpost dashboard: Settings Tab on the right and Click notification section
Select webhooks and activate Selected webhooks configuration –> “Return Order Placed”.
Important Links
Webhook Payload for Return Request Rejected
{
"waybill": "",
"status": "Return Request Rejected",
"timestamp": "2025-08-01T04:03:38Z",
"location": "",
"remark": "Return Request Rejected",
"clickpost_status_code": 102,
"clickpost_city": null,
"clickpost_status_description": "Return Request Rejected",
"account_code": "",
"cp_id": -1,
"rto_awb": null,
"reject_reason": "Missing tags",
"additional": {
"latest_status": {
"location": "",
"remark": "Return Request Rejected",
"clickpost_status_code": 102,
"clickpost_status_description": "Return Request Rejected",
"clickpost_status_bucket_description": "Return Request Rejected",
"status": "Return Request Rejected",
"clickpost_status_bucket": 8,
"timestamp": "2025-08-01T04:03:38Z"
},
"source": null,
"forward_order_id": "X12345",
"is_rvp": true,
"forward_awb": "1111111111",
"forward_reference_number": "12345-XZ02",
"notification_event_id": 23,
"self_shipped": false,
"item_info": [
{
"sku": "222222222",
"quantity": 1,
"return_reason": "Defective product was delivered",
"refund_mode": "Back to source",
"customer_comment": "Damage product \nFrom 2 3 sides",
"id": "1234422134",
"return_mode": "REFUND",
"description": "Black Mid Rise Cargo Pants",
"return_sub_reason": "I received a damaged or defective product",
"images": "https://www.shutterstock.com/image-photo/blank-collared-shirt-mock-template-600nw-1287554233.jpg",
"customer_uploaded_images": "",
"shopify_line_item_id": "1734917128379"
}
],
"return_reference_number": "RE61837379181283"
},
"request_placed_time": "2025-07-31T09:56:39Z",
"pickup_info": {
"customer_name": "Vijai Mahesh",
"customer_email": "[email protected]",
"customer_phone_number": "9999999999",
"pickup_state": "UP",
"pickup_address": "123, abc street, Bangalore, Karnataka",
"pickup_pincode": "560103",
"pickup_city": "Bangalore",
"pickup_country": "IN"
}
}
