Get Started

Twilio Client SDK for Android Quickstart

In this tutorial, we'll demonstrate using the Twilio Client APIs to make an outgoing call, receive an incoming call, and make calls between two Twilio Client devices.

This guide assumes you have familiarity with Android and Java, and concepts like Activities (and their lifecycles), Listeners, and how to build a basic Android application.


  1. Install Eclipse and the Android Developer Tools plugin. At the time of this writing, the latest available ADT version is 18.0.0,and we recommend you use at least that version.

  2. Install the Android SDK (recommended minimum of r18) and appropriate platform tools and platform API package. Note that the Client SDK depends on a minimum of API level 8 (Android 2.2), though you can of course build against newer API levels to use newer Android features. If you're not using API level 8, make sure to specify the appropriate API version in your file.

  3. Get a Twilio Account SID and Auth Token to initiate calls from your Android device. You will find these in your Account Dashboard. If you don't have an account, you can always sign up for a free trial account.

  4. A Twilio Application SID. A Twilio Application is a convenient way to store a set of URLs, like the VoiceUrl and SmsUrl on a phone number, but without locking them to a specific phone number. Visit the Apps tab to create an Application.

  5. (optional) An Android device. We recommend that you develop on a real Android device, as audio performance can be a bit choppy when using the Emulator, depending on the specs of your development machine. You'll also need two devices (or a device and the Emulator) to complete the final section of this Quickstart Tutorial.

Download the Android SDK

You can find all of the code from these tutorials in the quickstart folder of the Android SDK download.

Next: Setup »