Skip to content
API REFERENCES/
/Messages

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.

{
  "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"
  }
}