---
updatedAt: 2026-10-29T15:41:23.000Z
agentTools:
  projectIndex: https://docs.yotpo.com/llms.txt
---

# Review Request Eligible on Delivery

Sent when an order becomes eligible for a review request after it is delivered. Use it to send review requests from your own messaging platform.

To receive it, add `review_request.eligible.on_delivery` to `events` when you [create a filter](ref:create-filter), then [subscribe](ref:create-subscription) the filter to your target. Yotpo sends the event to your target URL as a `POST` with this JSON body.

The body has no event-name field. Read the event name from the `X-Yotpo-Webhooks-Event-Type` header.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Yotpo Webhooks",
    "description": "Events Yotpo sends to your webhook URL. Each event is an HTTP POST with a JSON body. To receive them, create a webhook target, a filter and a subscription.",
    "version": "3.0"
  },
  "webhooks": {
    "review_request.eligible.on_delivery": {
      "post": {
        "operationId": "review-request-eligible-on-delivery",
        "summary": "Review Request Eligible on Delivery",
        "description": "Sent when an order becomes eligible for a review request after it is delivered. Use it to send review requests from your own messaging platform.\n\nTo receive it, add `review_request.eligible.on_delivery` to `events` when you [create a filter](ref:create-filter), then [subscribe](ref:create-subscription) the filter to your target. Yotpo sends the event to your target URL as a `POST` with this JSON body.\n\nThe body has no event-name field. Read the event name from the `X-Yotpo-Webhooks-Event-Type` header.",
        "security": [],
        "parameters": [
          {
            "name": "X-Yotpo-Webhooks-Event-Type",
            "in": "header",
            "required": true,
            "description": "The event name.",
            "schema": {
              "type": "string"
            },
            "example": "review_request.eligible.on_delivery"
          },
          {
            "$ref": "#/components/parameters/WebhookTenantType"
          },
          {
            "$ref": "#/components/parameters/WebhookTenantId"
          },
          {
            "$ref": "#/components/parameters/WebhookMessageId"
          },
          {
            "$ref": "#/components/parameters/WebhookMessageIdPerTarget"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReviewRequestEligible"
              },
              "example": {
                "trigger": {
                  "type": "delivered",
                  "date": "2025-01-15T10:30:00Z"
                },
                "source_app_key": "B02uug6tF2uEA0Denhj0c9PV73y5PEOuKFmTCGb1",
                "order_id": "ORD-12345",
                "review_submission_url": "https://yotpo.com/go/aBcDeFg123",
                "shopper_profile": {
                  "email": "name@example.com",
                  "name": "John Smith",
                  "locale": "en-US"
                },
                "products": [
                  {
                    "product_id": "prod_001",
                    "variant_id": "var_001_blue_medium",
                    "product_title": "Classic Cotton T-Shirt",
                    "product_image_url": "https://cdn-yotpo-images-production.yotpo.com/Product/12345/67890/thumb.png"
                  },
                  {
                    "product_id": "prod_002",
                    "variant_id": "var_002_black",
                    "product_title": "Premium Denim Jeans",
                    "product_image_url": "https://cdn-yotpo-images-production.yotpo.com/Product/12346/67891/thumb.jpg"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return any 2xx status quickly to acknowledge the event. Without one, Yotpo retries at least 10 times with exponential backoff."
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "WebhookMessageId": {
        "name": "WebhookMessageId",
        "in": "header",
        "required": true,
        "description": "A unique ID for the event.",
        "schema": {
          "type": "string"
        },
        "example": "2f1c7a8e-5b1d-4c39-9a0e-3d7f2b6c1e44"
      },
      "WebhookMessageIdPerTarget": {
        "name": "WebhookMessageIdPerTarget",
        "in": "header",
        "required": true,
        "description": "A unique ID for this delivery to this target. Use it to ignore duplicates.",
        "schema": {
          "type": "string"
        },
        "example": "066c9f28-3e87-45d5-a67e-879d6090d989"
      },
      "WebhookTenantId": {
        "name": "X-Yotpo-Webhooks-Tenant-Id",
        "in": "header",
        "required": true,
        "description": "Your store ID.",
        "schema": {
          "type": "string"
        },
        "example": "YOUR_STORE_ID"
      },
      "WebhookTenantType": {
        "name": "X-Yotpo-Webhooks-Tenant-Type",
        "in": "header",
        "required": true,
        "description": "The kind of account the event belongs to.",
        "schema": {
          "type": "string"
        },
        "example": "store"
      }
    },
    "schemas": {
      "ReviewRequestEligible": {
        "type": "object",
        "properties": {
          "trigger": {
            "type": "object",
            "description": "What made the order eligible for a review request.",
            "properties": {
              "type": {
                "type": "string",
                "description": "`fulfilled` or `delivered`."
              },
              "date": {
                "type": "string",
                "description": "When the order was fulfilled or delivered.",
                "format": "date-time"
              }
            }
          },
          "source_app_key": {
            "type": "string",
            "description": "Your store ID."
          },
          "order_id": {
            "type": "string",
            "description": "Your order ID."
          },
          "review_submission_url": {
            "type": "string",
            "description": "A link to the review form for this order. Use it in your own review request message."
          },
          "shopper_profile": {
            "type": "object",
            "description": "The customer to ask for a review.",
            "properties": {
              "email": {
                "type": "string",
                "description": "The customer's email address."
              },
              "name": {
                "type": "string",
                "description": "The customer's name."
              },
              "locale": {
                "type": "string",
                "description": "The customer's locale, for example `en-US`."
              }
            }
          },
          "products": {
            "type": "array",
            "description": "The products in the order to ask about.",
            "items": {
              "type": "object",
              "properties": {
                "product_id": {
                  "type": "string",
                  "description": "Your product ID."
                },
                "variant_id": {
                  "type": "string",
                  "description": "Your variant ID."
                },
                "product_title": {
                  "type": "string",
                  "description": "The product title."
                },
                "product_image_url": {
                  "type": "string",
                  "description": "A URL of the product image."
                }
              }
            }
          }
        }
      }
    }
  }
}
```

# Sibling pages

* [Review Created](https://docs.yotpo.com/reference/review-create.md)
* [Review Updated](https://docs.yotpo.com/reference/review-updated.md)
* [Review Request Eligible on Fulfillment](https://docs.yotpo.com/reference/review-request-eligible-on-fulfillment.md)