# 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