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.

Operations

Send a message

Request

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.

Security

BearerAuth

Headers

X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/json

conversationstring(conversation)required

The unique identifier of the conversation

accommodationstring(common_accommodation)required

The unique identifier of the property

contentstringrequired

The body of the message.

attachmentsArray of strings

curl -i -X POST \
  https://demandapi.booking.com/3.2/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! This is my first message",
    "attachments": [
      "c325f460-1dc6-11f0-80f0-8d0908786f77"
    ]
  }'

Responses

Successful response.

Bodyapplication/json

request_idstring(requestId)

Uniquely identifies the request. Please provide this identifier when contacting support.

dataobject

Response

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