Webhooks: Reviews

Guesty's Open API allows you to send various reviews-related webhook notifications to your application's notification URL(s).

What Notifications Can I Receive?

New and updated guest reviews from Airbnb and Booking.com.
New and updated host reviews posted to Airbnb and Booking.com.

Why Create Reviews Webhooks?

Once your Guesty Open API integration is complete and finished with its initial synchronization of data, we recommend you to utilize the reviews webhook notification. Webhook notifications will help you save time and resources. Plus, you get to only synchronize the reviews data that has changed or is new and ignore that which has remained in the same state since the initial synchronization.

Reservation Reviewed Notification

This webhook notification is sent whenever a new guest review is synchronized with your Guesty account from Airbnb or Booking.com. Learn how to create this webhook here.

Notification Payload

Body Parameter	Data Type	Description
`_id`	string	Guesty review ID.
`externalReviewId`	string	External review ID.
`accountId`	string	Your Guesty account ID
`channelId`	string	The review source (`airbnb2` or `bookingCom`).
`createdAt`	string	The date and time the review was written and submitted.
`createdAtGuesty`	string	The date time the review was imported into Guesty.
`externalListingId`	string	Channel listing ID.
`externalReservationId`	string	Channel reservation ID.
`guestId`	string	Guesty ID of the guest.
`listingId`	string	Guesty listing ID.
`rawReview`	object	The review object.
`reservationId`	string	Guesty reservation ID.
`updatedAt`	string	Date and time of the most recent change on the channel.
`updatedAtGuesty`	string	Date and time that Guesty imported the change.
`reviewReplies`	[object]	Array of replies.
`event`	string	`reservation.reviewed`

Airbnb Reservation Reviewed Notification Example

{
   "_id":"62d00273f3a7c7ba7e016a14",
   "externalReviewId":"test_6",
   "accountId":"5db59615f6fc3b001f8ee56f",
   "channelId":"airbnb2",
   "createdAt":"2022-07-14T11:44:02.563Z",
   "createdAtGuesty":"2022-07-14T11:45:08.137Z",
   "externalListingId":"604153909318094860",
   "externalReservationId":"HMTZ9DWB9W",
   "guestId":"62330bdc1e874f003681cf32",
   "listingId":"5f90114acc5b51002979b1e0",
   "rawReview":{
      "id":729460318938454900,
      "reviewer_role":"guest",
      "reviewer_id":284554274,
      "reviewee_role":"host",
      "reviewee_id":50038747,
      "listing_id":53874861,
      "reservation_confirmation_code":"HMTHYT45AD",
      "hidden":false,
      "submitted":true,
      "overall_rating":2,
      "public_review":"The location is great and the house has all amenities two families with young kids need.\nHowever check in and check out times (very late and very early out), paired with extremely high cleaning fees (which are not even reflected in an extremely clean house) make it a unsatisfactory experience for the money.",
      "private_feedback":"- very late Check in and very early check out\n- for cleaning fee of 175€ you still need to take down the bed linen yourself…\n- additionally cleaning seemed to be only rudimentary done\n- sanitary areas a bit smelly (possibly apartment not used for some time or drains not working properly)\n- difficult to find the key (no distinguishing between inside housing complex or outer circle)",
      "id_str":"729460318938454957",
      "reviewer_id_str":"284554274",
      "reviewee_id_str":"50038747",
      "listing_id_str":"53874861",
      "expires_at":"2022-10-17T11:07:26.376Z",
      "first_completed_at":"2022-10-03T19:00:12.350Z",
      "submitted_at":"2022-10-03T19:41:31.457Z",
      "category_ratings_communication":3,
      "category_ratings_accuracy":2,
      "category_ratings_cleanliness":2,
      "category_ratings_location":4,
      "category_ratings_value":2,
      "category_ratings_checkin":1
   },
   "reservationId":"629208e3d5b216003488065e",
   "updatedAt":"2022-07-14T11:44:55.556Z",
   "updatedAtGuesty":"2022-07-14T11:45:08.137Z",
   "reviewReplies":[
      
   ],
   "event":"reservation.reviews"
}

Booking.com Reservation Reviewed Notification Example

{
   "_id":"62d001e7f3a7c7ba7e016a10",
   "externalReviewId":"test_3",
   "accountId":"5db59615f6fc3b001f8ee56f",
   "channelId":"bookingCom",
   "complexId":null,
   "createdAt":"2022-07-14T08:34:25.000Z",
   "createdAtGuesty":"2022-07-14T11:38:27.840Z",
   "externalComplexId":"6848541",
   "externalListingId":"684854101",
   "externalReservationId":"3117555697",
   "guestId":"62bff1d5cd6ede0033a88cb9",
   "listingId":"5f90114acc5b51002979b1e0",
   "rawReview":{
      "created_timestamp":"2022-10-06 14:10:36",
      "reply":null,
      "url":"https://supply-xml.booking.com/review-api/properties/7080721/reviews/EYg--v5_ktg",
      "scoring":{
         "staff":10,
         "clean":10,
         "facilities":10,
         "comfort":10,
         "review_score":9,
         "value":10,
         "location":10
      },
      "last_change_timestamp":"2022-10-06 14:41:37",
      "reviewer":{
         "is_genius":true,
         "country_code":"us",
         "name":"Lindsey"
      },
      "reservation_id":"3419318722",
      "review_id":"EYg--v5_ktg",
      "content":{
         "negative":"You could hear street traffic pretty badly from the bedroom. It wasn’t anything that stopped us sleeping but any light sleeper would be bothered. \nOverflow parking is a nightmare. If you’re coming back late at night and have to cross a dark bridge that also opens down to walk next to a river, it’s terrifying and dangerous. This either needs a lot more lighting and signs to indicate it’s actually where we should park, or guests unfamiliar with your area should get a special parking by the building.",
         "language_code":"en-us",
         "positive":"The little things like paper towels, cooking utensils, and soaps just made the stay a whole lot easier. It was super close to the center we had an event at. The guide to getting in the place was so straightforward.",
         "headline":"Really relaxing."
      }
   },
   "reservationId":"62bff1d6b36c21003322c233",
   "updatedAt":"2022-07-14T08:59:40.000Z",
   "updatedAtGuesty":"2022-07-14T11:40:28.309Z",
   "reviewReplies":[
      
   ],
   "event":"reservation.reviewed"
}