# review.submitted webhook

> The review.submitted webhook: a signed-in diner rated a dish of an order your backend sent, 1 to 5 stars.

Source: https://tamr.link/docs/webhooks/review-submitted

A diner rated a dish of an order your backend [sent](https://tamr.link/docs/api/send-order), 1 to 5 stars. One event per dish rated. The `webhook-id` is fixed by the review and the moment it was written, so sending the same stars again sends nothing, and a changed rating is a new event with the same `reviewId`: keep the latest `submittedAt`. A test key's diner writes nothing, but their ratings are still sent as test events (`reviewId` starting `test_`).

Only reviews from your app: a review left on Tamr's own QR menu sends none. The rating only: never words or a name. From the SDK this needs the next release (`requestReview`); an app that [draws its own chat](https://tamr.link/docs/guides/custom-chat) can use it today.

## The `data` object

| Field | Type | Description |
| --- | --- | --- |
| `reviewId` | string | 1 to 200 characters. |
| `externalUserId` | string | 1 to 200 characters. |
| `externalOrderId` | string or null | 1 to 200 characters. |
| `conversationId` | string or null | 1 to 200 characters. |
| `dishId` | string | 1 to 200 characters. |
| `externalId` | string or null | 1 to 200 characters. |
| `rating` | integer | 1 to 5. |
| `submittedAt` | string (date-time) |  |

## Examples

review.submitted:

```json
{
  "type": "review.submitted",
  "timestamp": "2026-11-03T12:00:00.000Z",
  "livemode": true,
  "data": {
    "reviewId": "rev_0001",
    "externalUserId": "user-88213",
    "externalOrderId": "A-99812",
    "conversationId": null,
    "dishId": "dish_kafta",
    "externalId": "SKU-1042",
    "rating": 5,
    "submittedAt": "2026-11-03T12:00:00.000Z"
  }
}
```

## A test event

What **Send a test event** in the dashboard sends: `livemode: false`, and every id starting `test_`.

review.submitted, test:

```json
{
  "type": "review.submitted",
  "timestamp": "2026-11-16T12:00:00.000Z",
  "livemode": false,
  "data": {
    "reviewId": "test_review",
    "externalUserId": "test_user",
    "externalOrderId": null,
    "conversationId": null,
    "dishId": "test_dish",
    "externalId": null,
    "rating": 5,
    "submittedAt": "2026-11-16T12:00:00.000Z"
  }
}
```
