Menu

Expand
Rate this page:

SMS API

SMS with Twilio Programmable Messaging helps you add robust messaging capabilities to your applications.

Using this REST API, you can:

Want more general information on Twilio and SMS? See our SMS with Twilio Programmable Messaging overview and the SMS API pricing page.

Base URL

All URLs referenced in the API documentation have the following base:

https://api.twilio.com/2010-04-01

The API is served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.

You can control your connectivity into Twilio’s platform by including your specific edge location in the subdomain. This will allow you to bring Twilio’s public or private network connectivity closer to your applications for improved performance.

For instance, customers with infrastructure in Germany can make use of the frankfurt edge location by using this base URL:

https://api.frankfurt.us1.twilio.com/2010-04-01

If you have a private connection through Interconnect in Germany, you can make use of the frankfurt-ix edge location by using this base URL:

https://api.frankfurt-ix.us1.twilio.com/2010-04-01

SMS API authentication

HTTP requests to the API are protected with HTTP Basic authentication. To learn more about how Twilio handles authentication, please refer to our security documentation.

In short, you will use your Twilio Account SID as the username and your Auth Token as the password for HTTP Basic authentication with Twilio.

curl -G https://api.twilio.com/2010-04-01/Accounts \
     -u <YOUR_ACCOUNT_SID>:<YOUR_AUTH_TOKEN>

You can find your Account SID and Auth Token in the Console.

To learn more about authentication and interaction with the Twilio REST API, check out our documentation for requests to the API and Twilio’s response.

Send messages with the SMS API

Twilio will now monitor messages to prevent content violating our Acceptable Use Policy (AUP). This helps to ensure and support Twilio Messaging as a trustworthy, high engagement channel and will not slow down the delivery of messages.

If a message you send has violated the AUP, it will be returned and you will receive an error code which identifies the necessary changes you need to make sending it again.

Twilio’s SMS API helps you send and manage messages programmatically:

You can also leverage the REST API to query metadata and manage your messages:

You’ll be able to find all relevant SMS API resources in the API Reference folder in the navigation bar on the left side of this page.

Leverage helper libraries to send and receive messages

Send and receive messages directly from your web application with the SMS API. For step-by-step instructions on how to do this with one of our supported helper libraries, check out the SMS quickstarts for:

Not using one of the supported helper libraries? Check out these additional articles that teach you how to send an SMS with:

Missing a language you like? If you follow the conventions in our curl code snippets throughout the documentation, you can translate the API call to your programming language of choice.

Loading Code Sample...
        
        

        Send an SMS using the Programmable SMS API

        Advanced applications built on Twilio’s SMS API

        Help integrating the SMS API

        Twilio’s SMS API is a flexible building block which can take you from sending your first text message all the way to sending and receiving millions.

        While we hope this page gives a good overview of what you can do with the API, we’re only scratching the surface. For help troubleshooting the API, see our SMS troubleshooting tips and learn how to use Twilio’s debugging tools.

        If you need any help integrating the SMS API or want to talk best practices, please get in touch. You can give us feedback using the survey on this page, speaking with support, talking to sales, or reaching out on Twitter.

        We can’t wait to see what you build!

        Rate this page:

        Need some help?

        We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

        Thank you for your feedback!

        Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        thanks-feedback-gif