Return Request Placed

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

API Guide

Webhook Payload Example

{
  "waybill": "",
  "status": "Return Request Placed",
	"timestamp": "2025-07-31T11:54:46Z",
  "location": "",
  "remark": "Return Request Placed",
  "clickpost_status_code": 101,
  "clickpost_city": null,
  "clickpost_status_description": "Return Request Placed",
  "account_code": "",
  "cp_id": -1,
  "rto_awb": null,
  "additional": {
    "latest_status": {
      "location": "",
      "remark": "Return Request Placed",
      "clickpost_status_code": 101,
      "clickpost_status_description": "Return Request Placed",
      "clickpost_status_bucket_description": "Return Request Placed",
      "status": "Return Request Placed",
      "clickpost_status_bucket": 8,
      "timestamp": "2025-07-31T11:54:46Z"
    },
    "source": null,
    "forward_order_id": "X12345",
    "is_rvp": true,
    "forward_awb": "1111111111",
    "forward_reference_number": "12345-XZ02",
    "notification_event_id": 11,
    "self_shipped": false,
    "item_info": [
      {
        "sku": "222222222",
        "quantity": 1,
        "return_reason": "Size or Fit Issues",
        "refund_mode": "Back to source",
        "customer_comment": "Feels too big, going for a smaller size",
        "id": "1234422134",
        "return_mode": "REFUND",
        "description": "Blue polo t-shirt",
        "return_sub_reason": "Product Doesn't fit well",
        "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-31T11:54:46Z",
  "pickup_info": {
    "customer_name": "Vijai Mahesh",
    "customer_email": "[email protected]",
    "customer_phone_number": "9999999999",
    "pickup_state": "Karnataka",
    "pickup_address": "123, abc street, Bangalore, Karnataka",
    "pickup_pincode": "560103",
    "pickup_city": "Bangalore",
    "pickup_country": "IN"
  }
}