New to the Vrbo API? How Vrbo access works, and what it lets you do · How to get Vrbo API access in 2026
Vrbo Guest Messaging
Read a Vrbo conversation and send messages in it through the host's Vrbo account — on the same paths and with the same body as Airbnb messaging. {threadId} is the Vrbo conversation id (externalThreadId, vrbo:<uuid>). To message a guest on any channel with one call, use POST /v1/conversations/{id}/messages — see Send a Message (/docs/send-message).
POST
/v1/channels/vrbo/messaging/:threadId/messagesParameters
threadIdstringRequiredThe Vrbo conversation id, vrbo:<uuid> (the bare uuid works too), from GET /v1/channels/vrbo/messaging.
messagestringRequiredThe text to send to the guest.
The routes
GET /v1/channels/vrbo/messaging— the workspace's Vrbo conversations, newest activity first (up to 200), each with the Vrbo account it belongs to (accountId,accountName). Filter withaccount_id(vrbo:…),listing_idorreservation_id.GET /v1/channels/vrbo/messaging/{threadId}— one conversation.GET /v1/channels/vrbo/messaging/{threadId}/messages— its messages, 50 a page newest first (?cursor=), or?all=truefor up to 1000 oldest first. The same shape as Airbnb's.POST /v1/channels/vrbo/messaging/{threadId}/messages— send.201withstatus: "sent";202withstatus: "queued"when Vrbo was slow and the send finishes in the background — do not send it again;conversation.message.status_changedsays when it went out. The message also shows onGET /v1/conversations/{id}/messages.
Differences from Airbnb
- Vrbo messages are text: a send with
mediaUrlis refused with422 attachments_not_supported. - Vrbo has no edit, unsend or reaction on a sent message, so there is no
PATCH …/messages/{messageId}on Vrbo. - Only conversations Vrbo itself holds are listed. A Vrbo booking that reached Repull another way (a PMS, an iCal feed) has no Vrbo conversation to message.
- New guest messages arrive within about a minute when the account's notification address is set up on Vrbo, and on a slower scheduled check when it is not.
Example
# The Vrbo conversations
curl 'https://api.repull.dev/v1/channels/vrbo/messaging' \
-H "Authorization: Bearer sk_live_YOUR_KEY"
# Send a message
curl -X POST 'https://api.repull.dev/v1/channels/vrbo/messaging/vrbo:3f2a9c1e-5b7d-4e2a-9c1f-0a1b2c3d4e5f/messages' \
-H "Authorization: Bearer sk_live_YOUR_KEY" \
-H "Idempotency-Key: welcome-812345" \
-H "Content-Type: application/json" \
-d '{"message": "Hi Anna — the hot tub is ready for your arrival."}'Response
{
"id": "9123456",
"conversationId": 812345,
"channel": "vrbo",
"status": "sent",
"direction": "outbound",
"contentRewritten": false,
"submittedContent": "Hi Anna — the hot tub is ready for your arrival.",
"deliveredContent": "Hi Anna — the hot tub is ready for your arrival.",
"attachments": []
}AI