# review.created

A customer wrote a product review.

Scope: `reviews:read`

The name of the reviewer is not included. See [Customer support and reviews](/guides/support).

## Payload `data`

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string | no | Review ID. |
| `product_id` | string | no | Product ID. |
| `product_name` | string | no |  |
| `rating` | integer | no | 1 to 5. |
| `text` | string | no |  |
| `approved` | boolean | no | Visible in the store. |
| `created_at` | date-time | no |  |


## Example delivery

```http
POST /larm/webhooks HTTP/1.1
Host: app.example.com
Content-Type: application/json
x-larm-event: review.created
x-larm-event-id: 0b7c2f8e-1d3a-4c5b-9e6f-7a8b9c0d1e2f
x-larm-delivery: 2b9f6c1e-8d4a-4f30-a7e5-c1d9b8a7f604
x-larm-timestamp: 1792060982
x-larm-secret-generation: 1
x-larm-payload-version: 1
x-larm-signature: v1=5d41402abc4b2a76b9719d911017c592e1c7b0d3f6a8e2b4c9d0f1a2b3c4d5e6
```

```json
{
  "app_id": "1f2e3d4c-5b6a-4978-8695-a4b3c2d1e0f9",
  "data": {
    "id": "77",
    "product_id": "311",
    "product_name": "Top-up card 100 SAR",
    "rating": 5,
    "text": "The code arrived within seconds.",
    "approved": false,
    "created_at": "2026-10-14T18:22:10Z"
  },
  "id": "0b7c2f8e-1d3a-4c5b-9e6f-7a8b9c0d1e2f",
  "installation_generation": 1,
  "installation_id": "c7e4a1f2-6b3d-4e8a-9c05-1d2f3a4b5c6d",
  "occurred_at": "2026-10-15T09:13:02Z",
  "payload_version": 1,
  "resource": {
    "type": "review",
    "id": "77",
    "version": 1
  },
  "store_id": "5b1d7a62-0c4e-4f38-9a51-2e7b3c9d8f10",
  "test": false,
  "type": "review.created"
}
```