Messaging API (2.0.0)

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

API for retrieving the operator↔partner conversation stored against a booking.

Bookable relays the conversation between the venue operator and the integration partner over email (both parties email a per-booking conversation alias and Bookable forwards each message on).

Participants can take part in two ways:

• By email — reply to the relay email from their normal mail client (attachments supported this way only).
• Programmatically — POST /bookings/{bookingId}/messages to send a plain-text message. Bookable stores it and relays it on to the other participant over the same conversation channel. GET returns the stored conversation stack.

The send direction is derived from the caller's role: an Integration Partner sends to the venue operator (partner_to_operator); a venue group operator sends to the integration partner (operator_to_partner). Each stored message carries this absolute direction.

Pagination: Uses page-based pagination via pageNumber and pageSize. Results are ordered by sentAt ascending (oldest first).

Availability: Real email relay is not available in the Sandbox environment. In Sandbox only the webhook-only test flow is reachable — see the direction override on SendMessageRequest, which stores the message and fires the message.received webhook to your registered sandbox callback without sending any email.