A module for using the Twilio REST API and generating valid TwiML.

Install from PyPi using pip

pip install twilio

Getting started with the Twilio API couldn't be easier. Create a Twilio REST client to get started. For example, the following code makes a call using the Twilio REST API.

TwilioRestClient needs your Twilio credentials. While these can be passed in directly to the constructor, we suggest storing your credentials as environment variables. Why? You'll never have to worry about committing your credentials and accidentally posting them somewhere public.

The TwilioRestClient looks for TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN inside the current environment.

from twilio.rest import TwilioRestClient

account = "AXXXXXXXXXXXXXXXXX"
token = "YYYYYYYYYYYYYYYYYY"
client = TwilioRestClient(account, token)

call = client.calls.create(to="9991231234", from_="9991231234",
                           url="http://foo.com/call.xml")
print call.length
print call.sid

TwilioRestClient needs your Twilio credentials. While these can be passed in directly to the constructor (see above), we suggest storing your credentials as environment variables. Why? You'll never have to worry about committing your credentials and accidentally posting them somewhere public.

The TwilioRestClient looks for TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN inside the current environment.

from twilio.rest import TwilioRestClient
client = TwilioRestClient()

To control phone calls, your application need to output TwiML. Use twilio.twiml..Response to easily create such responses.

from twilio import twiml

r = twiml.Response()
r.play("monkey.mp3", loop=5)
print str(r)

<?xml version="1.0" encoding="utf-8"?>
<Response><Play loop="5">monkey.mp3</Play><Response>

The full power of the Twilio API is at your finger tips. The full documentation explains all the awesome features available to use.