---
title: "Send SMS"
method: POST
path: "/v2/sms"
tags: ["SMS"]
---

# Send SMS

`POST /v2/sms`

Send a message from sender to recipient using the values shown in the parameters section.

## Request body

- SendSMSRequest
  - `message` string, required — Body text of the message. The message will be split into multiple parts if required. A part is 160 characters for a single SMS or 153 characters per part for multi-part SMS. If the message contains Unicode UTF8 encoded characters such as emoji’s or non latin character sets, then a single part is 70 characters or 67 characters for multiple parts. More information on message length and encoding: https://support.transmitsms.com/s/article/44001076957-how-many-characters-can-i-have-in-my-text-message If opt-out is required, insert parameter [opt-out-link] into the message and a link will be generated.
  - `message_ref` string — A reference supplied by your system. This reference will be passed back in webhooks so that you can relate events to messages you sent. For example, being able to relate a Link Hit event to a specific sent message.
  - `sender` string, required — Sender is the number (or alphanumeric) that the message appears from on the handset. Sender number must be assigned to your account for the country you are sending to. Contact us to get sender number(s) registered to your account. Sender number functionality varies by country. You can send from an alphanumeric sender if it is available for the destination country. Global SMS delivery list: https://support.transmitsms.com/s/article/page-products-connectivity-global-delivery-list Alphanumeric senders (which cannot be replied to) have a maximum of 11 characters. Only letters, numbers, underscore, hyphen or space are allowed and they are included in the total character count. (Consecutive underscore, hyphen, space is not allowed.)
  - `recipient` string, required — The destination number for delivery. Can be either in local format or in international format. Must be in the same country as the sender. For international format, it should follow E.164 standard. http://en.wikipedia.org/wiki/E.164 Examples of conversions to E.164 format: Australia 0438 333 061 => 61438333061 New Zealand 0212172782 => 64212172782 USA (281) 869-1226 => 12818691226
  - `track_links` boolean — Enable the link tracking feature which replaces links in outbound messages with shortened links. This allows us to track when recipients view links.

## Response `200`

The SMS that was sent

- SMSResponse — SMS message details.
  - `id` string, required — Unique identifier for the SMS message.
  - `recipient` string, required — The destination number for delivery.
  - `recipient_country` string, required — Recipient country code.
  - `sender` string, required — The sender number.
  - `sender_country` string, required — Sender country code.
  - `message_ref` string, required — Reference supplied by your system.
  - `message` string, required — Body text of the SMS message.
  - `status` string, required — Status of the message.
  - `sms_count` string, required — Number of SMS parts the message was split into.
  - `is_gsm` boolean, required — Whether the message uses GSM encoding.
  - `is_sandbox` boolean, required — Deprecated. Will be removed in a future version.
  - `routed_via` string, required — The route used to send the message.
  - `track_links` boolean, required — Whether link tracking is enabled.
  - `direction` string, required — Direction of the message (IN/OUT).
  - `created_at` string, required — Timestamp when the SMS was created.
  - `updated_at` string, required — Timestamp when the SMS was last updated.

---

[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/versions/9f6c34b849af/schema)