---
title: "Sends an SMS"
method: POST
path: "/sms"
tags: ["SMS"]
---

# Sends an SMS

`POST /sms`

## Request

- Base URL: `https://cpaas.zoho.com/v1.1`
- URL: `https://cpaas.zoho.com/v1.1/sms`
- Auth: API key in header `Authorization`

Sends SMS to a single recipient number. The sender and the template must be pre-configured for the sending agent. 

The base message template is a pre-approved SMS template of the sender, addressed by `template_key` or `template_alias`. The `merge_info` is used to  resolve the final content by merging the template with values. Params left unresolved are sent literally. `sender_key` identifies the sender of the SMS. ‘to’ is exactly a single recipient, whose `mobile_no` must include the country code.

## Request body

- SmsSendSmsRequest: Request body for sending a single SMS. Provide exactly one of `template_key` / `template_alias`; the template supplies the message text.
  - `sender_key` string, required: Key of the SMS sender the message goes out as. The sender must be configured for the sending agent.
  - `to` SmsRecipient[], required: Exactly one recipient.
    - `mobile_no` string, required: Recipient mobile number, including the country code.
  - `template_key` string, uuid: Key of a pre-approved SMS template of the sender. Provide this or `template_alias`.
  - `template_alias` string: Alias of a pre-approved SMS template. Provide this or `template_key`.
  - `merge_info` SmsMergeInfo: Key-value map that resolves the template's `{{merge_tags}}`. Tags left unresolved are sent literally in the message text.
  - `client_reference` string: Client-supplied reference identifier, echoed in the SMS logs.

## Response `200`

SMS queued for delivery.

- SmsSendSmsResponse: Success response returned when the SMS is queued for delivery.
  - `data` object
    - `code` string: Acceptance code.
    - `message_id` string, uuid: Unique identifier of the message. Use it with the message-details API.
    - `message` string
    - `request_id` string: Unique identifier assigned to the send request.
  - `status` string

## Other responses

- `400`: Bad Request - a required field is missing (`TM_3301`/`SERR_110`, `TM_3201`/`GE_102`) or a value is malformed (`TM_3301`/`SERR_102`). Please check the parameters and the syntax.
- `401`: Access Denied (`TM_4001`) - missing or invalid API token, or a template that is not associated with the sending agent. Please check the authorization details and try again.
- `422`: Unprocessable Entity (`TM_3501`) - a recipient entry is invalid, such as an empty mobile number. Please check if all parameters are valid.

---

[API](https://skmtc.dev/zoho/apis/zoho-cpaas.md) - [All operations](https://skmtc.dev/zoho/apis/zoho-cpaas/llms.txt) - [OpenAPI document](https://skmtc.dev/zoho/apis/zoho-cpaas/revisions/f0858a38e8b0?raw)