# Send channel message (/en/api-reference/api-ref/signaling/channel-message)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

Sends a channel Signaling message from the server.

- OpenAPI: /openapi/rtm/signaling-rest.en.yaml
- Operation ID: send-channel-message
- Method: POST
- Path: /{appid}/rtm/users/{user_id}/channel_messages

## Servers

- https://api.agora.io/dev/v2/project

## Parameters

- `appid` (path, required) - The App ID of your Agora project.
- `user_id` (path, required) - Signaling user ID to send a channel message. It must not exceed 64 characters in length or be an empty string. Since `user_id` is a URL parameter, the first and last characters must not be a space.

## Request body

- `channel_name` (string, required) - Signaling channel name to receive a channel message. It must not exceed 64 characters in length or be an empty string.
No schema.
- `enable_historical_messaging` (boolean) - Whether to save as a historical message.

- `true`: Save as a historical message.
- `false`: Do not save as a historical message.
No schema.
- `payload` (string, required) - Content of the channel message. It must not be an empty string or exceed 32 KB in length.
No schema.

## Responses

### 200

The request was successful. The response body contains the result of the request.

- `result` (string) - Request result. `success` if the request succeeds, `failed` if it fails.

Request result.

 - success: The request succeeds.
 - failed: The request fails.
No schema.
- `request_id` (string) - Unique ID to identify this request.
No schema.
- `code` (string) - Message status: `message_sent`.

Message status.

 - message_sent: The message is sent.
No schema.
### default

The request failed. The response body includes the error code and description.

No schema.