Messages

Provides endpoints for two-way post-booking communication between guests and properties.

Use these endpoints to send and retrieve messages, exchange images, and check conversation details.

Operations

Send a message

Request

Sends a message within a conversation. The message body supports plain text. Optionally, attach a file by referencing a previously uploaded attachment ID.

Security

BearerAuth

Headers

X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/jsonrequired

conversationstringrequired

Unique identifier of the conversation.

accommodationstringrequired

Unique identifier of the property.

contentstringrequired

The message text to send.

attachmentsArray of strings

Optional list of attachment IDs, if sending one or more files.

curl -i -X POST \
  https://demandapi.booking.com/3.1/messages/send \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "conversation": "8586a789-44f4-5521-9f27-f5efd097cba6",
    "accommodation": "6819547",
    "content": "Hello, I'\''m your guest!.",
    "attachments": [
      "c325f460-1dc6-11f0-80f0-8d0908786f77"
    ]
  }'

Responses

Message sent successfully.

Bodyapplication/json

request_idstring

Unique identifier for this request. Provide this ID when contacting support.

dataobject

Response

{
  "request_id": "cdb0b154-2eae-481b-8fee-fb2725296e1f",
  "data": {
    "message": "3164e570-19e0-11f0-baca-e5019c8df435"
  }
}