Pre-approve Inquiry

Pre-approves an inquiry on the host's behalf, which tells the guest they may book. On Airbnb this is the same as pressing Pre-approve. On Booking.com it approves the guest's request to book. On VRBO it sends the inquiry's quote back unchanged, as the VRBO app does, with the message you send to the guest (required on VRBO). VRBO support is built from a captured VRBO app request and is not yet tried on a live account; the VRBO app also sends an App Check header Host Tools can't send, so VRBO may refuse it.
The reservation must have source "Airbnb", "Booking" or "VRBO" and status "inquiry". Requires the reservations:write scope.

The channel is the source of truth: Host Tools sends the pre-approval to the channel, then refreshes the reservation from it. The new status (preapproved) shows up in /api/getReservation/{reservationID}, and the reservation webhook fires, shortly after the call returns, not in the response itself.

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

_id of the Airbnb, Booking.com or VRBO inquiry to pre-approve

Body Params
string

Message to the guest sent with the pre-approval. Required on VRBO. Airbnb and Booking.com pre-approvals can't carry one, so leave it out there and send it with /api/sendMessage/{reservationID} instead.

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