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.

POST/v1/channels/vrbo/offers

Parameters

typestringRequired

preapproval (the guest may book their dates at the listed price) or offer (a quote on your terms).

thread_idstringRequired

The Vrbo conversation, vrbo:<uuid> (externalThreadId on GET /v1/channels/vrbo/messaging). threadId is accepted too.

messagestring

A note Vrbo shows the guest with the pre-approval or quote.

start_datestring

Offer: first night, YYYY-MM-DD, with nights. Leave both out to keep the guest's dates.

nightsinteger

Offer: number of nights.

guest_detailsobject

Offer: number_of_adults (or number_of_guests), number_of_children, number_of_pets.

rental_amountnumber

Offer: the rent for the stay, before fees and taxes.

feesarray

Offer: [{ "type": "CLEANING", "value": 120 }], Vrbo fee types. Replaces the quote's fees.

damage_depositnumber | null

Offer: 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, fees and damage_deposit; total_price is refused. The answer carries Vrbo's guest total (totalPrice) and its lines.
  • One live quote per conversation: GET and DELETE take ?thread_id= rather than an offer id, and the quote's id is always current.
  • No instant-book switch on a pre-approval (block_instant_booking is refused), and a quote is always for the conversation's own property (listing_id is refused).
  • Both types can carry a message.

Validation and errors

  • The body is checked before anything reaches Vrbo; 422 invalid_params names 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-Key on the POST, 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
}
AI