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

Installation

Install from PyPi using pip

pip install twilio

Getting Started

Getting started with the Twilio API couldn't be easier. Create a TwilioRestClient and you're ready to go.

API Credentials

To get started, the TwilioRestClient needs your Twilio credentials. You can either pass these directly to the constructor (see the code below) or via environment variables.

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.

from twilio.rest import TwilioRestClient

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

Alternatively, a TwilioRestClient constructor without these parameters will look for TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN inside the current environment.

from twilio.rest import TwilioRestClient
client = TwilioRestClient()

Making a Call

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.sid

Handling a call using TwiML

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.say("Welcome to twilio!")
print str(r)

<?xml version="1.0" encoding="utf-8"?>
<Response><Say>Welcome to twilio!</Say></Response>

Digging Deeper

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