Decline Booking Request

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}.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

_id of the pending Airbnb, VRBO, internal or direct reservation, or Booking.com inquiry, to decline

Body Params
string
enum

Why the request is declined. Required for Airbnb, Booking.com and VRBO; leave it out for an internal or direct request. The lower-case values are Airbnb's and the upper-case values are Booking.com's; use the list for the reservation's source. A VRBO request takes either.

string

With a lower-case reason only, and required there. Message the channel sends the guest with the decline (Airbnb and VRBO). Leading and trailing spaces are trimmed; it can't be empty.

string

Airbnb only. Optional private note to Airbnb about why. The guest never sees it.

string
length ≤ 255

Booking.com only, and required with NOT_COMFORTABLE (not allowed with any other reason). A short explanation for Booking.com; the guest never sees it. On a VRBO request, the explanation is kept by VRBO.

Headers
string

Partner API key (deprecated — use OAuth 2.0 for new integrations)

string

User's authentication token (legacy). Use Authorization Bearer header for new integrations.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json