---
updatedAt: 2026-07-16T12:34:50.000Z
agentTools:
  siteIndex: https://developer.rmlconnect.net/llms.txt
  projectIndex: https://developer.rmlconnect.net/route-mobile-project/llms.txt
---

# Fallback to SMS

> **Use this API to send an RCS text message with SMS fallback when RCS delivery is unavailable.**

## Endpoint details

| Field                   | Value                                        |
| ----------------------- | -------------------------------------------- |
| Endpoint URL            | <https://apis.rmlconnect.net/rcs/v1/message> |
| Method                  | `POST`                                       |
| Content-Type            | `application/json`                           |
| Authentication Required | Yes                                          |

## Authentication

Pass a valid access token in the `Authorization` header.

## Request headers

| Header        | Required | Description                            |
| ------------- | -------- | -------------------------------------- |
| Authorization | Yes      | Valid access token for authentication. |
| Content-Type  | Yes      | Must be `application/json`.            |

## Request body parameters

| Field              | Type   | Description                                  |
| ------------------ | ------ | -------------------------------------------- |
| type               | string | Message type. Use `text`.                    |
| phone\_no          | string | Recipient phone number.                      |
| bot\_name          | string | RCS bot name.                                |
| text               | string | Text message sent through RCS.               |
| extra              | string | Additional custom value.                     |
| fallback\_channel  | string | Fallback channel. Use `sms`.                 |
| sms                | object | SMS fallback message details.                |
| sms.fallback\_text | string | Text sent through SMS if RCS is unavailable. |

<Callout icon="fa-solid fa-circle-info" theme="info">
  ###

  If the primary RCS channel is unavailable, the message can fall back to SMS using the `fallback_channel` and `sms.fallback_text` fields.
</Callout>

## Request body

```json
{
  "type": "text",
  "phone_no": "{phone}",
  "bot_name": "XXXXXX",
  "text": "Hello",
  "extra": "mumbai",
  "fallback_channel": "sms",
  "sms": {
    "fallback_text": "YourtestOTPis{#var#}-29Three"
  }
}
```

## Response

```json
{
  "message": "Message request has been created",
  "id": "9035789a-2a6f-11f0-874a-0a58a9feac021"
}
```

## Error responses

No error response example is provided for this API.