Docs/Documentation/Learn

Send Message

Send messages to guests through their original booking platform — Airbnb, Booking.com, VRBO, or any other connected channel.

When to use this endpoint

Reply to a guest inquiry or question
Send check-in instructions before arrival
Automate post-booking confirmation messages
Build an AI-powered guest communication workflow

Platform routing

Messages are delivered through the original booking platform. A guest who booked on Airbnb receives the message in their Airbnb inbox. Direct booking guests receive it via the channel you configured (email, SMS, or both).

Sending is channel-specific

Sending a message routes through the guest's original booking platform, so there is one send endpoint per channel — there is no generic POST /v1/conversations/{id}/messages. The /v1/conversations routes are read-only (a POST there returns 405 Method Not Allowed). Use the Airbnb or Booking.com endpoint below.

Send on Airbnb

POST/v1/channels/airbnb/messaging/{threadId}/messages

curl -X POST "https://api.repull.dev/v1/channels/airbnb/messaging/THREAD_123/messages" \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hi Sarah! Your check-in is confirmed for July 10th at 3 PM. The door code is 4829. Let me know if you need anything!"
  }'

Path parameters

threadIdstringRequired

The Airbnb thread id (the external thread identifier). Get it from the Airbnb messaging list endpoint or a reservation's thread.

Body parameters

messagestringRequired

The message text to send to the guest.

mediaUrlstring

Optional. URL of an image or attachment to send with the message.

mediaTypestring

Optional. The media type of the attachment referenced by mediaUrl.

Send on Booking.com

POST/v1/channels/booking/messaging

curl -X POST "https://api.repull.dev/v1/channels/booking/messaging" \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "property_id": 123,
    "conversation_id": "CONV_456",
    "message": "Hi Sarah! Your check-in is confirmed for July 10th at 3 PM."
  }'

Body parameters

property_idintegerRequired

The Booking.com property id the conversation belongs to.

conversation_idstringRequired

The Booking.com conversation id. Get it from GET /v1/channels/booking/messaging.

messagestringRequired

The message text to send to the guest.

Response

On success the Airbnb endpoint returns 201 Created with the delivered message from the platform; the Booking.com endpoint returns the platform's send result. Both wrap the payload in the standard data envelope.

Common examples

Reply to a guest message on Airbnb

curl -X POST "https://api.repull.dev/v1/channels/airbnb/messaging/THREAD_123/messages" \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Great question! The parking spot is #12 in the underground garage. You can access it with the same door code."
  }'

Send an image attachment on Airbnb

curl -X POST "https://api.repull.dev/v1/channels/airbnb/messaging/THREAD_123/messages" \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Here is a map of the parking garage.",
    "mediaUrl": "https://example.com/parking-map.png",
    "mediaType": "image/png"
  }'

API Reference

See the complete Conversations API Reference for all endpoints including list conversations and read messages.

Previous← List Conversations NextList Reviews →