# Messages

This API collection enables two-way communication between guests and properties. Use these endpoints to send and receive messages, include attachments, follow conversations, and more.

## Send a message

 - [POST /messages/send](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/messages/send.md): Use this endpoint to send a message to a conversation. You can include plain text and optionally attach a file using an attachment ID from a previous upload.

## Retrieve latest messages

 - [POST /messages/latest](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/messages/latest.md): Use this endpoint to fetch the most recent messages, including messages sent by both the property and the guest. By default, up to 100 messages are returned in reverse chronological order (newest first).

This endpoint is ideal for:
- Synchronising message threads between your system and the Booking.com platform.
- Polling for updates to detect new messages since your last request.

## Confirm message receipt

 - [POST /messages/latest/confirm](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/messages/confirm.md): Use this endpoint to confirm receipt of messages. Confirmation is required in order to receive new messages from POST /messages/latest.

## Retrieve attachment metadata

 - [POST /messages/attachments/metadata](https://developers.booking.com/demand/docs/open-api/3.2-beta/demand-api/messages/metadata.md): Use this endpoint to get basic information about an uploaded file, such as its name, type, and size.