review.completed - Way Docs

When it fires

Way sends review.completed when a review is created for a booking - that is, when a guest submits their rating and feedback for an experience they attended. Events arrive at your endpoint as a POST request with the body { "event": "review.completed", "payload": { ... } }. When a webhook secret is set, the X-Way-Signature header carries an HMAC of the request body - see Verify signatures.

Payload

Field	Type	Description
`id`	string (UUID)	Unique identifier of the review.
`bookingId`	string (UUID)	Unique identifier of the reviewed booking.
`rating`	number	Star rating given in the review.
`recommendability`	number	Recommendability score given in the review.
`text`	string	Text of the review.
`reviewedAt`	string (ISO 8601)	Timestamp when the review was submitted.
`experiencedDate`	string (ISO 8601)	Start date and time of the reviewed booking’s session.
`experience.id`	string (UUID)	Unique identifier of the experience.
`experience.title`	string	Title of the experience.
`brand.id`	string (UUID)	Unique identifier of the brand.
`brand.name`	string	Display name of the brand.
`brand.tier`	string	Subscription tier of the brand.
`brand.countryCode`	string	Country code of the brand.
`brand.currency`	string	Currency code used by the brand.
`brand.externalReferenceId`	string \| null	External reference identifier configured for the brand.
`reviewer.id`	string (UUID)	Unique identifier of the reviewer.
`reviewer.fullName`	string	Full name of the reviewer.
`reviewer.emailAddress`	string	Email address of the reviewer.
`reviewer.loyaltyMemberId`	string \| null	Loyalty member identifier associated with the booking, if any.

Sample

Illustrative payload derived from the event schema.

{
  "event": "review.completed",
  "payload": {
    "id": "6f2c1b8e-4d3a-4f5b-9e07-1a2b3c4d5e6f",
    "bookingId": "a4b16eba-f47a-49da-be4f-b6f9e1c01dec",
    "rating": 5,
    "recommendability": 10,
    "text": "The guided hike was the highlight of our stay. Beautiful views and a great guide!",
    "reviewedAt": "2026-02-23T18:05:12.331Z",
    "experiencedDate": "2026-02-21T14:00:00.000Z",
    "experience": {
      "id": "7a78a18a-aa8f-456b-9fef-b43e0814401d",
      "title": "Guided Coastal Hike"
    },
    "brand": {
      "id": "8e12bfdc-a74c-48e2-8a76-2996a359c10c",
      "name": "The Seaside Hotel",
      "tier": "growth",
      "currency": "USD",
      "countryCode": "US",
      "externalReferenceId": "ABC"
    },
    "reviewer": {
      "id": "f0d9c8b7-a6e5-4d43-b2c1-0e9f8a7b6c5d",
      "fullName": "Alice Rivera",
      "emailAddress": "alice@example.com",
      "loyaltyMemberId": null
    }
  }
}

List an experience’s reviews with Get Experience Reviews.

​When it fires

​Payload

​Sample

​Related endpoints

When it fires

Payload

Sample

Related endpoints