> For the complete documentation index, see [llms.txt](https://docs.connectedyou.io/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.connectedyou.io/knowledge-base/connectedyou-platform/user-guide/sim-management/sim-profiles/send-sms.md).

# Send SMS

The **Send SMS** feature allows you to send SMS messages directly from the ConnectedYou platform (Currently via API only) to a subscriber’s device (SIM / ICCID).

This is typically used for:

* Notifications
* Alerts
* OTPs (where applicable)
* Service-related communication

Messages are sent programmatically via API and delivered through telecom operator networks to the end device.

{% hint style="info" %}

### Supported Profiles

The A2P SMS feature is currently supported only for the following profiles:

* CYTL02
* CYTL07
* CYTL10
* CYTL14
* CYTL22
* CYTL23
* CYTL25
* CYTL26
* CYTM01
* CYTM02
  {% endhint %}

### Access Method

This feature is **API-only** and is not available via the UI yet.

* **Send SMS API**: [*Send SMS*](https://docs.api.connectedyou.io/#05e5b8e3-5922-4c79-9d11-c7e701cde623)
* **Get SMS List API**: [*List SMS*](https://docs.api.connectedyou.io/#9869ecf2-ea4d-4c37-91c3-f00d4227bab1)

### SMS Requirements

When sending an SMS, the following constraints apply:

* Only **text (alphabetic / standard characters)** is supported
* Special encoding or non-text formats are not supported
* Maximum message length: **160 characters**

### Validity Period Explained

Each SMS request includes a **validity period**, which defines how long the telecom network will attempt to deliver the message.

#### How it works

When an SMS is sent:

* If the device is **online**, the message is delivered immediately
* If the device is **offline** (e.g., switched off or out of coverage), the message is stored in the **SMSC (Short Message Service Center)**
* The SMSC will continue trying to deliver the message **until the validity period expires**

If the device does not become reachable within this time, the message is discarded.

#### Supported Validity Range

* Minimum: **5 minutes**
* Maximum: **7 days**
* Unit: **Minutes**

#### Default Behavior

* If no validity period is provided in the API request:
  * ConnectedYou will automatically set it to **24 hours**

### Viewing Sent SMS (Per ICCID)

Customers can retrieve the list of SMS messages sent to a specific ICCID using the [**Get SMS List API**.](https://docs.api.connectedyou.io/#9869ecf2-ea4d-4c37-91c3-f00d4227bab1)

#### Key Points

* SMS history is available **per ICCID**
* The API returns messages that have been sent to that specific SIM
* Useful for:
  * Auditing
  * Debugging delivery issues
  * Tracking communication history


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.connectedyou.io/knowledge-base/connectedyou-platform/user-guide/sim-management/sim-profiles/send-sms.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.