Webhooks: Reviews

Webhook notifications for Airbnb and Booking.com guest 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 ParameterData TypeDescription
_idstringGuesty review ID.
externalReviewIdstringExternal review ID.
accountIdstringYour Guesty account ID
channelIdstringThe review source (airbnb2 or bookingCom).
createdAtstringThe date and time the review was written and submitted.
createdAtGuestystringThe date time the review was imported into Guesty.
externalListingIdstringChannel listing ID.
externalReservationIdstringChannel reservation ID.
guestIdstringGuesty ID of the guest.
listingIdstringGuesty listing ID.
rawReviewobjectThe review object.
reservationIdstringGuesty reservation ID.
updatedAtstringDate and time of the most recent change on the channel.
updatedAtGuestystringDate and time that Guesty imported the change.
reviewReplies[object]Array of replies.
eventstringreservation.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"
}