---
title: "Sending SMS messages to the USA"
description: "Find out how to comply with the specific rules for sending SMS messages to the United States and apply them via the OVHcloud Control Panel"
url: https://docs.ovhcloud.com/en/guides/web-cloud/messaging/sms/envoi-de-sms-aux-etats-unis
lang: en
lastUpdated: 2022-08-05
---
# Sending SMS messages to the USA

:::info
OVHcloud SMS offers are only available in the following countries: France, the United Kingdom, Ireland, Spain, Italy and Poland.
:::

## Objective

Sending SMS messages to the United States requires compliance with specific rules. This guide explains these rules and shows how to apply them.

## Requirements

- An [OVHcloud SMS account](https://www.ovhcloud.com/en-gb/sms/) with SMS credits.
- Access to the [OVHcloud API](https://eu.api.ovh.com/) (for the API method only)


***

### OVHcloud Control Panel Access

- **Direct link:** <ManagerLink to="/#/telecom/sms">SMS</ManagerLink>
- **Navigation path:** <code className="action">Telecom</code> > <code className="action">SMS</code> > Select your SMS account

***


![SMS Telecom Control Panel](/images/assets/screens/control-panel/product-selection/telecom/tpl-telecom-03-en-sms.png)
## Instructions

### Step 1: Understanding the restrictions

In accordance with the US SMS regulation authority (Neustar), a message template must be validated through our services before an SMS can be sent to this destination.
Only alert and two-factor authentication messages are authorised, and advertising SMS templates are not accepted. Once you have set your templates, the SMS will be sent the same way as for other countries.

You can request the validation of multiple message templates.

:::info
Setting message templates is free and is carried out by the OVHcloud teams within two working days.

:::

### Step 2: Adding a template

#### 2.1 Via the Control Panel

Click on the `Message and campaign
` tab and click `SMS management
`.
Finally, click `Manage templates
`.
![SMS messages to the USA](/images/web-cloud/messaging/sms/envoi-de-sms-aux-etats-unis/smstousa1.png)
On the next page, click on `Actions
` then on `Add
`.
![SMS messages to the USA](/images/web-cloud/messaging/sms/envoi-de-sms-aux-etats-unis/smstousa2.png)
A pop-up will appear with fields to complete.

![SMS messages to the USA](/images/web-cloud/messaging/sms/envoi-de-sms-aux-etats-unis/smstousa3.png)
| Field       | Description                                                                                       |
| ----------- | ------------------------------------------------------------------------------------------------- |
| Name        | Template name                                                                                     |
| Activity    | Select the template type:<br />- Alert<br />- Authentication<br />- Transaction processing system |
| Description | Template description                                                                              |
| Template    | Write the template, including the variable between #                                              |

#### 2.2 Via APIs

:::tip
If you are not familiar with using the OVHcloud API, please refer to our guide on [Getting started with the OVHcloud API](/en/guides/manage-and-operate/api/first-steps.md).

:::

Log in to [api.ovh.com/](https://eu.api.ovh.com/), then use the following API:


[🇪🇺POST/sms/{serviceName}/templatesControl](https://eu.api.ovh.com/console/?section=/sms&branch=v1#post-/sms/-serviceName-/templatesControl)

![SMS messages to the USA](/images/web-cloud/messaging/sms/envoi-de-sms-aux-etats-unis/smstousa4.png)
Fill in the required fields and click on `Execute
`.
#### Examples of templates

Below are two examples of message templates that can be sent to the US.

- Authentication template example:

```bash
Your security code is: #CODE#. Have a good day!
```

- Alert template example:

```bash
Our monitoring system detected your server #SERVER# doesn't respond to ping requests
```

### Step 3: Analysing returns

Once your message template has been created and validated, the outgoing SMS automatically compares your content with your templates. If the comparison is positive, the SMS is sent in the same way as one sent to another recipient.

If you send an SMS to the US without creating and validating a template, the SMS will be rejected and the Premium Tracking Transaction Code (PTT code) 1999 will be sent to you, which corresponds to the "No templates available" error message.

You can view the other possible return codes in the [SMS users guide](/en/guides/web-cloud/messaging/sms/sms-users.md).

## Go further

Join our [community of users](https://community.ovhcloud.com/).
