Get Started with the SMS API

TeleSign’s SMS API is a REST API that allows you to easily send SMS messages. You can send alerts, reminders, and notifications, or you can send verification messages containing one-time passcodes (OTP).

This page provides instructions and references for features of the SMS API and associated tools.

• General Information
• Send an SMS
• Obtain Transaction Status Results
• Buy a Phone Number (Sender ID)
• Inbound SMS
• URL Shortener
• SMS API Examples
• Compliance
• Next Steps

General Information

All requests submitted for the SMS API:

• Can be authenticated with Basic (easiest to implement) and Digest
• Use https://rest-ww.telesign.com/v1/messaging as the base endpoint
• Accept only UTF-8 encoded unicode characters as inputs
• Use Content-Type application/x-www-form-urlencoded in request headers

Send an SMS

For quick instructions about how to send your first SMS, see the Send an SMS page.

For a list of available parameters, see the SMS Request page.

Obtain Transaction Status Results

You can find out the status of your transactions two ways:

• Status Request - quickly get the status of a transaction with a GET request.
• Transaction Callback - TeleSign uses a POST request to post status information about your transactions to a URL that you provide. (Recommended for high volume transactions.)

Read more about these options on the Obtain Transaction Status Results page.

Buy a Phone Number (Sender ID)

TeleSign offers the option of buying a sender ID to use to send messages to your end users. A sender ID is sometimes referred to as a dedicated phone number.

You can use the Phone Numbers API to buy a phone number. This is best if you do not need to buy numbers in areas that have special restrictions. Details about the Phone Numbers API (and what areas have restrictions) are available on the Get Started with the Phone Numbers API page.

Alternatively, you can speak with your TAM to purchase one or more phone numbers to use as a sender ID. You need at least one if you want to receive messages using Inbound SMS.

Inbound SMS

If you need to receive messages back from customers, an optional feature that can be made available is inbound SMS. You can learn more about this feature by reviewing the Inbound SMS page.

If you want to enable this feature, you must have:

• a phone number available for use as a sender ID
• a callback URL

URL Shortener

To help shorten your text messages, TeleSign provides a complimentary URL shortening service. You can read more about how to enable it here: URL Shortener.

SMS API Examples

This section provides examples of a request and response using the SMS API.

POST Request and Response Examples

You use a POST request to send your message.

Here is an example POST response (when you use transaction callbacks to retrieve status information):

GET Request and Response Examples

You use a GET request to retrieve status information about your POST request.

The GET response body looks like this: