Sending SMS messages to the USA

Find out how to send SMS messages to the USA

Last updated 5th August 2022

Objective

There are specific rules for sending SMS to the United States. The guide will explain the rules and show you how to apply them, so that you can send SMS messages to the US.

Requirements

  • An OVHcloud SMS account with SMS credits.
  • Access to the OVHcloud API (for the API method only)
  • You must be logged in to OVHcloud Control Panel, in the Telecom section, then SMS.

SMS Telecom Control Panel

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.

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

Log in to your OVHcloud Control Panel, then select Telecom. Next, click SMS and select your SMS account. Click on the Message and campaign tab then click SMS management.

Finally, click Manage templates.

SMS messages to the USA

On the next page, click on Actions then on Add.

SMS messages to the USA

A pop-up will appear with fields to complete.

SMS messages to the USA

Field Description
Name Template name
Activity Select the template type:
- Alert
- Authentication
- Transaction processing system
Description Template description
Template Write the template, including the variable between #

2.2 Via APIs

If you are not familiar with using the OVHcloud API, please refer to our guide on Getting started with the OVHcloud API.

Log in to api.ovh.com/, then use the following API:

SMS messages to the USA

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:
Your security code is: #CODE#. Have a good day!
  • Alert template example:
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 this guide.

Go further

Join our community of users on https://community.ovh.com/en/.


Did you find this guide useful?

Please feel free to give any suggestions in order to improve this documentation.

Whether your feedback is about images, content, or structure, please share it, so that we can improve it together.

Your support requests will not be processed via this form. To do this, please use the "Create a ticket" form.

Thank you. Your feedback has been received.


These guides might also interest you...

OVHcloud Community

Access your community space. Ask questions, search for information, post content, and interact with other OVHcloud Community members.

Discuss with the OVHcloud community

In accordance with the 2006/112/CE Directive, modified on 01/01/2015, prices exclude VAT. VAT may vary according to the customer's country of residence.