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"
    }
  ]
}

Top-Level Fields:

Field	Required	Description
name	Yes	Customer’s full name
email	Yes	Customer’s email address

Fields Inside Each order Array Item:

Field	Required	Description
pn	Yes	Product name (shown in the review request email)
pid	Yes	Unique product identifier (your internal ID or SKU)
pu	Yes	Full URL of the product page on your website
piu	No	Full URL of the product image
sku	No	Product SKU (for your reference and tracking)
vrntid	No	Variant ID (if the product has size/color variants)

Important: The field names inside the order array (pn, pid, pu, piu, sku, vrntid) must be exactly as shown above. Do not use the longer field names from the single-product format (e.g., use pn not productName).

Field mapping in WiserReview dashboard:

---

Example: Sending the Webhook with cURL

Here’s how to test the webhook from a terminal:

curl -X POST "YOUR_WEBHOOK_URL" 
  -H "Content-Type: application/json" 
  -d '{
    "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"
  }'

Replace YOUR_WEBHOOK_URL with the URL generated in Step 2.

---

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 (set in your review request automation settings), WiserReview sends the review request email to the customer.
3. The customer clicks the link in the email and submits their review.

✅ Make sure email is always included — it’s required to send the review request.

---

Quick Reference: Which Setup Should I Use?

Scenario	Toggle Setting	Payload Format	Webhook Calls Per Order
Always 1 product per order	OFF (default)	Single product fields	1
Multiple products, want separate emails per product	OFF (default)	Single product fields	1 per product
Multiple products, want one email per order	ON (Multiple Product)	order array	1
Mix of single & multi-product orders	ON (Multiple Product)	order array	1 (works for both)

---

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 in your dashboard.
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.
Some orders have 1 product, some have many	Enable the “Multiple Product Order” toggle and always use the order array format. It handles both cases.