Send Special Offer

Sends a special offer to an inquiry on the host's behalf: dates, guests and a total price the guest can book. On Airbnb this is the same as sending a special offer from the inbox. On VRBO it edits the inquiry's quote, as the VRBO app does; the listing's fees stay as VRBO quotes them for the new dates and the rent is the price less those fees.
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. Booking.com has no special offers.
The reservation must have source "Airbnb" or "VRBO" and status "inquiry" or "preapproved". Requires the reservations:write scope. Host Tools refreshes the reservation from the channel afterwards.

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

_id of the Airbnb or VRBO inquiry

Body Params
string
required

Check-in date (YYYY-MM-DD)

string
required

Check-out date (YYYY-MM-DD)

guests
object
required
number
required

Total for the stay in the listing's currency, including the cleaning fee and the listing's other fees, before taxes and the channel's guest service fee. Airbnb needs a whole number.

string

Message to the guest sent with the offer. VRBO only; on Airbnb send it with /api/sendMessage/{reservationID}.

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