Declines a request to book on the host's behalf: on Airbnb, Booking.com or VRBO, or one Host Tools owns (an internal or direct reservation). Requires the reservations:write scope.
Airbnb: the reservation must have source "Airbnb" and status "pending". Give one of Airbnb's reasons (lower case) and a messageToGuest.
Booking.com: the reservation must have source "Booking" and status "inquiry" (a request still waiting for the host's answer). Give one of Booking.com's reasons (upper case), plus reasonText when the reason is NOT_COMFORTABLE. Booking.com doesn't take a message to the guest and never shows the guest the reason, so messageToGuest and messageToAirbnb are refused.
VRBO: the reservation must have source "HomeAway" and status "pending". Give a reason from either list: Host Tools sends VRBO the closest of VRBO's own reasons, or "Other" with the reason's words. With a lower-case reason, messageToGuest goes to the guest with the decline; an upper-case reason sends no message. VRBO leaves the requested dates as they are; block them in Host Tools to close them on every channel.
On the channels, the channel is the source of truth: Host Tools sends the action to the channel, and the new status shows up in /api/getReservation/{reservationID}, and the reservation webhook fires, shortly after the call returns, not in the response itself.
Internal and direct: the reservation must have source "internal" or "direct" and status "pending". Send no body: there is no channel to give a reason or a message to. The reservation is denied by the time the call returns, the status a declined Airbnb or VRBO request gets, and a reservation.changed webhook follows with status "denied". Host Tools sends the guest nothing. The host can decline the same request in Host Tools, which sends the same webhook. To end a reservation that is already accepted, use /api/cancelReservation/{reservationID}.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||