> For the complete documentation index, see [llms.txt](https://docs.sendune.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sendune.com/sms.md).

# SMS

**SENDUNE** integrates with your AWS SNS account to send SMS (Text Messages). You can send SMS manually, via the API, or via automated rules (workflows). 

### **Manual SMS** 

To send SMS manually, go to the 'SMS > Manual' tab, select one or more contacts and click "Send" button at the top. You will be shown a popup where you can compose your SMS. See video for demo.

{% embed url="<https://iframe.mediadelivery.net/play/274833/82be1be0-d3bc-467d-a7bf-9eccd2f1064e>" %}

{% hint style="info" %}
**NOTEs:**&#x20;

* Sender ID is optional. Enter only if you have one.&#x20;
* Origination number is required only if you are sending to USA mobile numbers.
  {% endhint %}

### **API SMS**&#x20;

Use this to send Transactional SMS. See the request/response details below.

{% embed url="<https://iframe.mediadelivery.net/play/274833/8a1c7492-55bd-482c-94cb-fc1b69aa82d2>" %}

{% tabs %}
{% tab title="API Request" %}

<pre><code><strong>URL: https://api.sendune.com/send-sms
</strong></code></pre>

{% code lineNumbers="true" %}

```
{
      "method": "POST",
      "url": "https://api.sendune.com/send-sms",
      "headers": {"template-key": "**************************4lVm"},
      "body": {
          "sender_id": "ABCDEF",
          "origination_number": "+449876543212",
          "mobile": "+449876543210",
          "message": "Hello John."
       }
}
```

{% endcode %}

**IMPORTANT:**

* All API calls MUST include the **Template Key**. Template Key is unique to Transactional SMS and Marketing SMS.
* 'Origination Number' is required only when sending to USA mobile numbers.&#x20;
* All mobile numbers MUST be in E.164 format.&#x20;
  {% endtab %}

{% tab title="API Response" %}
Success Response:

{% code lineNumbers="true" %}

```
{
      "success": true,
      "message": "SMS Sent"
}
```

{% endcode %}

Failed Response:

{% code lineNumbers="true" %}

```
{
      "success": false,
      "message": "message details",
      "error": "error details"
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

### **Workflow SMS**

See '[<mark style="color:red;">Automation</mark>](/email-automation.md)' section for more details.