Messaging use cases and best practices
Learn how to integrate the Messaging API into your platform by exploring common use cases for guest and property messaging.
For property platforms
These use cases are intended for property-side platforms representing accommodation partners.
Send a welcome message after a booking
Send a personalised welcome message to guests as soon as a new booking is confirmed.
How to implement:
- Monitor your reservation system for new bookings.
- Call /messages/send endpoint with the
reservation
,accommodation
, and your welcomecontent
.
Example request:
{
"reservation": "4380765874",
"accommodation": 2098153,
"content": "Thank you for booking with us! We look forward to welcoming you. Let us know if you have any special requests."
}
If no conversation exists yet, this request will automatically start one.
Retrieve new guest messages every 10 minutes
Set up regular polling to retrieve new messages sent by guests.
How to implement:
- Every 10 minutes, call /messages/latest.
- Extract new messages from the response.
- (Optional) Confirm receipt using /messages/latest/confirm.
Example request to confirm receipt:
{
"messages": ["123e4567-e89b-12d3-a456-426614174000", "987f6543-e21d-65c4-b789-426614174999"]
}
Confirming messages prevents repeated delivery of the same content.
Display a full message history in your UI
Show all past messages in your customer support or partner dashboard.
How to implement:
- Use /messages/latest to get the latest messages.
- Extract the
conversation
,reservation
, andaccommodation
values. - Call /messages/conversations with those values.
Example request:
{
"conversation": "cc872746-77f2-5886-ba7c-17e0497241b5",
"accommodation": 2098153,
"reservation": 4380765874
}
The response includes the full message history, including timestamps, senders, and attachments (if any).
This is useful for resolving disputes, tracking guest requests, or viewing communication logs.
Messages remain accessible for up to 1 year after checkout or cancellation.
For guest platforms
These actions are typically used by platforms representing travellers.
Send a message about a booking
Guests can send a message about their stay—e.g. to ask about parking or check-in time.
How to implement:
- Call /messages/send with the reservation, accommodation, and the message content.
Example:
{
"reservation": "4380765874",
"accommodation": 2098153,
"content": "Hi! What time is check-in? Is there parking available on-site?"
}
If the conversation doesn’t exist yet, it will be created automatically.
Check for property replies
Fetch the latest responses from the property.
How to implement:
- Periodically call /messages/latest to see new replies.
- Display messages in your guest-facing app.
- Confirm receipt with /messages/latest/confirm.
View past conversations
Let guests view their previous conversations during or after their stay.
How to implement:
- Use /messages/latest to find the conversation.
- Call /messages/conversations using the conversation, reservation, and accommodation IDs.
Note: Guests can access messages for up to 66 days after checkout or cancellation.
- Get started - Try the messaging flows
- Refer to the Managing messages guide for instructions on sending and receiving messages.