Decline Booking Request

post

https://app.hosttools.com/api/declineReservation/{reservationID}

Declines a request to book on the host's behalf, on Airbnb or Booking.com. 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.

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

reservationID

string

required

_id of the pending Airbnb reservation or Booking.com inquiry to decline

Body Params

reason

string

enum

required

Why the request is declined. The lower-case values are Airbnb's and the upper-case values are Booking.com's; use the list for the reservation's source.

messageToGuest

string

Airbnb only, and required there. Message Airbnb sends the guest with the decline. Leading and trailing spaces are trimmed; it can't be empty.

messageToAirbnb

string

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

reasonText

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.

Headers

apiKey

string

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

authToken

string

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

Responses

200The channel declined the request

405The channel refused the request. Its reason is in message, for example when an Airbnb request expired or the guest withdrew it before Host Tools heard about it. Booking.com reports those as a 409.

409The request can't be declined any more: on Airbnb it isn't pending, on Booking.com it isn't an inquiry (already answered or expired), or Booking.com says the request can no longer change. message says which.