How to Send Review Requests (New Order) Using Webhook

You can set up WiserReview to automatically send review request emails when a customer places a new order. This works by using a Webhook — your system sends order details to WiserReview via an HTTP POST request, and WiserReview triggers the review request email to your customer.

Before You Start: Choose Your Review Email Setup

Before configuring the webhook, decide how you want review request emails to work. There are two approaches:

Option A: One Email Per Product (Default)

• Your system sends one webhook call per product.
• Each call triggers a separate review request email.
• Best when you want customers to review one product at a time.

Example: A customer orders Product A, Product B, and Product C.
→ Your system sends 3 separate webhook calls.
→ Customer receives 3 separate review request emails — one for each product.

Option B: One Email for All Products in an Order

• Your system sends one webhook call with all products included in the payload.
• Customer receives one email asking them to review all products.
• Requires enabling the “Multiple Product Order” toggle in webhook settings.
• Best when you want a single consolidated email per order.

Example: A customer orders Product A, Product B, and Product C.
→ Your system sends 1 webhook call with all 3 products.
→ Customer receives 1 email asking for reviews on A, B, and C.

FAQ: Do I need two separate webhooks if some orders have 1 product and some have multiple?
No. You only need one webhook. If you enable the “Multiple Product Order” toggle, you can send all orders through the same webhook — whether the order has 1 product or 10. Just always include the order array in your payload. An order array with a single product works perfectly.

---

Step 1: Open Webhook Integration

1. Log in to your WiserReview dashboard.
2. Click Integrations from the left menu.
3. In the search bar, type Webhook.
4. Find: “Webhook – Fire review requests on new order events”
5. Click the Integration button.

This opens the Webhook setup screen.

Step 2: Create a Connection

1. In the “Name your connection” box, type any name (e.g., “My Store Orders”).
2. Click the green Create button.
3. WiserReview will generate a Webhook URL.

Copy this URL — your system will send order data to it via HTTP POST requests with a JSON body.

Step 3: Send Order Data

Send an HTTP POST request to your Webhook URL with the JSON payload in the request body. Set the header Content-Type: application/json.

Option A: Single Product Per Webhook Call

Use this when you’re sending one webhook call per product. The “Multiple Product Order” toggle should be OFF (default).

Example JSON Payload:

{
  "email": "[email protected]",
  "name": "John Doe",
  "productId": "SKU-123",
  "productName": "Wireless Headphones",
  "productImage": "https://yourstore.com/images/headphones.jpg",
  "productUrl": "https://yourstore.com/products/wireless-headphones"
}

Field Reference:

Field	Required	Description
email	Yes	Customer’s email address
name	Yes	Customer’s full name
productId	Yes	Unique product identifier (your internal ID or SKU)
productName	Yes	Product name shown in the review request email
productImage	No	Full URL of the product image
productUrl	Yes	Full URL of the product page on your website

Field mapping in WiserReview dashboard:

---

Option B: Multiple Products in One Webhook Call

Use this when you want one email for all products in an order. You must first enable the “Multiple Product Order” toggle:

Example JSON Payload:

{
  "name": "John Doe",
  "email": "[email protected]",
  "order": [
    {
      "pn": "Wireless Headphones",
      "pid": "SKU-123",
      "pu": "https://yourstore.com/products/wireless-headphones",
      "piu": "https://yourstore.com/images/headphones.jpg",
      "sku": "SKU-123",
      "vrntid": "VRNT-BLK"
    },
    {
      "pn": "Phone Case",
      "pid": "SKU-456",
      "pu": "https://yourstore.com/products/phone-case",
      "piu": "https://yourstore.com/images/phone-case.jpg",
      "sku": "SKU-456",
      "vrntid": "VRNT-RED"
    }
  ]
}

Example: Sending the Webhook with cURL

curl -X POST "YOUR_WEBHOOK_URL" 
  -H "Content-Type: application/json" 
  -d '{
    "email": "[email protected]",
    "name": "John Doe",
    "productId": "SKU-123",
    "productName": "Wireless Headphones",
    "productUrl": "https://yourstore.com/products/wireless-headphones"
  }'

What Happens After You Send the Webhook

1. The order is recorded in your WiserReview dashboard under the webhook connection.
2. After the configured delay, WiserReview sends the review request email to the customer.
3. The customer clicks the link in the email and submits their review.

Troubleshooting

Problem	Solution
Customer not receiving the review email	Verify that email is included and valid in the payload.
Review request not triggered	Confirm the webhook URL is correct and the connection is active.
Multiple product email not working	Make sure the “Multiple Product Order” toggle is enabled and the payload uses the order array format.
Wrong product shown in email	Check that productName / pn and productUrl / pu values are correct.