# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.