Menu

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

SMS API

Twilio's Programmable SMS API helps you add robust messaging capabilities to your applications.

Using this REST API, you can send and receive SMS messages, track the delivery of sent messages, and retrieve and modify message history.

Want more general information on Twilio and SMS? See our Programmable SMS 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

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

SMS API authentication

HTTP requests to the REST 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 your 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'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 left nav on this page.

Leverage the 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...
      
      
      
      

      Advanced applications built on Twilio's SMS API

      Messaging Channels with the Twilio API

      SMS and MMS aren't your only messaging choice with this API. You can also integrate Twilio's REST API with WhatsApp, LINE, RCS and Facebook Messenger.

      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!

      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 browsing the Twilio tag on Stack Overflow.