---
title: "Send Message"
method: POST
path: "/conversations/{conversation_id}"
tags: ["Messages"]
---

# Send Message

`POST /conversations/{conversation_id}`

Send a text or image message to the guest. <br><br>**This endpoint is not idempotent and does not return a message ID.** If a request times out, the outcome is unknown — Hostex cannot determine whether the channel has already delivered the message, and this uncertainty cannot be resolved on our side, so no idempotency guarantee is offered. If you receive an error, retry as appropriate — in our experience, a guest receiving a duplicate message is better than a guest receiving no message at all.

## Path parameters

- `conversation_id` string, required

## Request body

- object
  - `message` string — The text content of the message. Max length depends on the limit of different channels.
  - `jpeg_base64` string — The base64 encoded string of the JPEG image.

## Response `200`

The request has been successfully submitted.

- CommonResponse
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.

---

[API](https://skmtc.net/hostex/apis/hostex-api.md) · [All operations](https://skmtc.net/hostex/apis/hostex-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostex/hostex-api/versions/a3fa555dee66/schema)