Return Request Approved

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 for Return Request Approved

{
  "waybill": "",
  "status": "Return Request Approved",
  "timestamp": "2025-07-31T11:54:55Z",
  "location": "",
  "remark": "Return Request Approved",
  "clickpost_status_code": 1007,
  "clickpost_city": null,
  "clickpost_status_description": "Return Request Approved",
  "account_code": "",
  "cp_id": -1,
  "rto_awb": null,
  "additional": {
    "latest_status": {
      "location": "",
      "remark": "Return Request Approved",
      "clickpost_status_code": 1007,
      "clickpost_status_description": "Return Request Approved",
      "clickpost_status_bucket_description": "Return Request Approved",
      "status": "Return Request Approved",
      "clickpost_status_bucket": 8,
      "timestamp": "2025-07-31T11:54:55Z"
    },
    "source": null,
    "forward_order_id": "X12345",
    "is_rvp": true,
    "forward_awb": "1111111111",
    "forward_reference_number": "12345-XZ02",
    "notification_event_id": 22,
    "self_shipped": false,
    "item_info": [
      {
        "sku": "222222222",
        "quantity": 1,
        "return_reason": "Size or Fit Issues",
        "refund_mode": "Back to source",
        "customer_comment": "I want to order L size. xl doesn't fit me well",
        "id": "1234422134",
        "return_mode": "REFUND",
        "description": "Blue Printed Knitted Pullover",
        "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"
  }
}