Vrbo Offers
Pre-approve a Vrbo inquiry or send a quote, read the live quote, or withdraw it — the counterpart of Airbnb offers, with the same body, addressed by the Vrbo conversation. If you have the Repull conversation id, POST /v1/conversations/{id}/pre-approval and /special-offers do the same — see Vrbo inquiries & offers.
/v1/channels/vrbo/offersParameters
typestringRequiredpreapproval (the guest may book their dates at the listed price) or offer (a quote on your terms).
thread_idstringRequiredThe Vrbo conversation, vrbo:<uuid> (externalThreadId on GET /v1/channels/vrbo/messaging). threadId is accepted too.
messagestringA note Vrbo shows the guest with the pre-approval or quote.
start_datestringOffer: first night, YYYY-MM-DD, with nights. Leave both out to keep the guest's dates.
nightsintegerOffer: number of nights.
guest_detailsobjectOffer: number_of_adults (or number_of_guests), number_of_children, number_of_pets.
rental_amountnumberOffer: the rent for the stay, before fees and taxes.
feesarrayOffer: [{ "type": "CLEANING", "value": 120 }], Vrbo fee types. Replaces the quote's fees.
damage_depositnumber | nullOffer: refundable damage deposit; null for none.
Differences from Airbnb
- Priced by its parts. Vrbo adds its taxes and service fee itself, so a quote takes
rental_amount,feesanddamage_deposit;total_priceis refused. The answer carries Vrbo's guest total (totalPrice) and its lines. - One live quote per conversation:
GETandDELETEtake?thread_id=rather than an offer id, and the quote'sidis alwayscurrent. - No instant-book switch on a pre-approval (
block_instant_bookingis refused), and a quote is always for the conversation's own property (listing_idis refused). - Both types can carry a
message.
Validation and errors
- The body is checked before anything reaches Vrbo;
422 invalid_paramsnames the field to fix. 404 not_found— no Vrbo conversation with that id in the workspace (an Airbnb thread id is refused here).403 listing_inactive— the conversation's listing is inactive.409 inquiry_no_longer_open— the inquiry moved on (booked, expired, withdrawn); do not retry.- Send
Idempotency-Keyon thePOST, so a retry after a timeout cannot send the guest two quotes.
Example
# Pre-approve an inquiry
curl -X POST https://api.repull.dev/v1/channels/vrbo/offers \
-H "Authorization: Bearer sk_live_YOUR_KEY" \
-H "Idempotency-Key: preapprove-812345" \
-H "Content-Type: application/json" \
-d '{"type": "preapproval", "thread_id": "vrbo:3f2a9c1e-5b7d-4e2a-9c1f-0a1b2c3d4e5f", "message": "Those dates are free — book whenever you are ready."}'
# Send a quote
curl -X POST https://api.repull.dev/v1/channels/vrbo/offers \
-H "Authorization: Bearer sk_live_YOUR_KEY" \
-H "Idempotency-Key: quote-812345-1" \
-H "Content-Type: application/json" \
-d '{
"type": "offer",
"thread_id": "vrbo:3f2a9c1e-5b7d-4e2a-9c1f-0a1b2c3d4e5f",
"start_date": "2026-11-06",
"nights": 3,
"guest_details": { "number_of_adults": 4 },
"rental_amount": 780,
"fees": [{ "type": "CLEANING", "value": 120 }]
}'
# Read, then withdraw, the quote
curl "https://api.repull.dev/v1/channels/vrbo/offers?thread_id=vrbo:3f2a9c1e-5b7d-4e2a-9c1f-0a1b2c3d4e5f" \
-H "Authorization: Bearer sk_live_YOUR_KEY"
curl -X DELETE "https://api.repull.dev/v1/channels/vrbo/offers?thread_id=vrbo:3f2a9c1e-5b7d-4e2a-9c1f-0a1b2c3d4e5f" \
-H "Authorization: Bearer sk_live_YOUR_KEY"Response
{
"id": "current",
"conversationId": "812345",
"channel": "vrbo",
"status": "sent",
"checkIn": "2026-11-06",
"checkOut": "2026-11-09",
"nights": 3,
"totalPrice": 1011.4,
"currency": "USD",
"rentalAmount": 780,
"fees": [{ "type": "CLEANING", "value": 120, "label": "Cleaning fee" }],
"damageDeposit": null
}