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/messages

Parameters

threadIdstringRequired

The Vrbo conversation id, vrbo:<uuid> (the bare uuid works too), from GET /v1/channels/vrbo/messaging.

messagestringRequired

The 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 with account_id (vrbo:…), listing_id or reservation_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=true for up to 1000 oldest first. The same shape as Airbnb's.
  • POST /v1/channels/vrbo/messaging/{threadId}/messages — send. 201 with status: "sent"; 202 with status: "queued" when Vrbo was slow and the send finishes in the background — do not send it again; conversation.message.status_changed says when it went out. The message also shows on GET /v1/conversations/{id}/messages.

Differences from Airbnb

  • Vrbo messages are text: a send with mediaUrl is refused with 422 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