---
title: "Send RCS message"
method: POST
path: "/v2/rcs/messages"
tags: ["RCS"]
---

# Send RCS message

`POST /v2/rcs/messages`

This endpoint is in beta and may change in future versions.
Sends an RCS message to a single recipient.

## Request body

- RcsRequest
  - `sender` string, required — The RCS agent ID assigned to your registered agent. Unlike SMS, WhatsApp, and MMS, RCS messages do not come from a phone number. They are always sent through an agent. - Must be a registered RCS agent identifier. - Example: `DemoSender` - Can be alphanumeric or numeric.
  - `recipient` string, phone, required — The destination number for delivery. Can be either in local format or in international format. For international format, it should follow the [E.164 standard](http://en.wikipedia.org/wiki/E.164). Examples of conversions to E.164 format: - Australia: 0438 333 061 → 61438333061 - UK: 07123 456 789 → 447123456789
  - `content_type` 'text', required — Type of the message content (currently only text supported).
  - `content` object, required — The message content to be sent. - Supports both Basic RCS messages (160 characters) and Simple RCS messages (3072 characters) - UTF-8 and emoji support included
    - `text` RCSText, required — Text content for the message.
      - `message` string, required — The text message body. **Message Types:** - **Basic RCS Messages**: Up to 160 characters (SMS format in RCS) - **Simple RCS Messages**: Up to 3072 characters with emoji and UTF-8 support
  - `sms_fallback` RCSSMSFallback — Provides intelligent fallback for non-RCS capable devices and carrier delivery issues. If the RCS message fails, the SMS will send the configured message to the recipient instead.
    - `sender` string — The sender number to use for SMS fallback, which can be in [E.164](http://en.wikipedia.org/wiki/E.164) international format or an alphanumeric sender ID.
    - `message` string, required — The message to send through SMS. SMS messages are subject to certain character limitations, please read our SMS documentation for details.
  - `message_ref` string — A reference supplied by your system. Maximum length of 500 characters. This reference is included in webhook events so you can relate events with the original message. For example, being able to relate a Link Hit event to a specific sent message.

## Response `200`

OK

- object
  - `data` object, required — Success response payload
    - `id` string, required — Unique identifier for the message.
    - `message_ref` string — Optional reference ID set by the user for the message.
    - `sender` string, required — Registered RCS Agent ID.
    - `recipient` string, required — Recipient phone number in international format.
    - `content_type` 'text', required — Type of the message content.
    - `content` object, required — Content of the message.
      - `text` RCSText, required — Text content for the message.
        - `message` string, required — The text message body. **Message Types:** - **Basic RCS Messages**: Up to 160 characters (SMS format in RCS) - **Simple RCS Messages**: Up to 3072 characters with emoji and UTF-8 support
    - `sms_fallback` RCSSMSFallback — Provides intelligent fallback for non-RCS capable devices and carrier delivery issues. If the RCS message fails, the SMS will send the configured message to the recipient instead.
      - `sender` string — The sender number to use for SMS fallback, which can be in [E.164](http://en.wikipedia.org/wiki/E.164) international format or an alphanumeric sender ID.
      - `message` string, required — The message to send through SMS. SMS messages are subject to certain character limitations, please read our SMS documentation for details.
    - `created_at` string, date-time, required — Timestamp in RFC3339 format (e.g., 2025-08-26T10:30:00Z) when the message was created on the server.
  - `request` object — Optional metadata (e.g. requestId, traceId)
  - `meta` object — Optional pagination, feature flags, etc.

## Other responses

- `400` — Input Validation Error
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/kudosity/apis/transmit-sms-api.md) · [All operations](https://skmtc.net/kudosity/apis/transmit-sms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kudosity/transmit-sms-api/revisions/9f6c34b849af/schema)