Get Started

Twilio Connect Quickstart

Overview

Twilio Connect is an easy way for developers to obtain authorization to make calls, send text messages, purchase phone numbers, read access logs and perform other API functions on behalf of another Twilio account holder.

As an example, imagine you want to access the Twilio account of a user of your web application to provide in-depth analytics of their Twilio account activity. In this quickstart we'll solve this problem by creating your first Twilio Connect App, placing the "Connect" button on your web site so users can authorize your app to access their Twilio account data and make API requests against their account.

Creating Your First Twilio Connect App

Let's jump right in and create our first Connect app. Log in to your Twilio account dashboard, select "Apps" and click the "Create Connect App" button. Fill in the top section with the name of your application and your company information.

Next, assign an Authorize URL to your Connect application. The Authorize URL is the URL that Twilio will redirect the user's browser to after they have authorized your application to access their Twilio account. Later on in the quickstart we'll demonstrate how the Authorize URL is used.

Lastly, select the access rights your Connect app requires on the user's account. For this example we'll only be accessing call logs for analytics so we'll choose "Read all account data".

Here's what our sample Connect application looks like:

Rossum Twilio Connect App

Click ‘Save Changes' and you're done!

Placing the Connect Button on Your Web Site

Twilio Connect

The Connect button is where your customers will start the process of authorizing your Connect App to access their Twilio account. We've made it easy to create the code needed to place this button on your web site with the Twilio Connect button HTML generator.

After saving your application you will see a bit of HTML code in a popup. Copy the generated code and paste it into the HTML of your web site where you would like the button to appear. If you ever need to generate this HTML again, you can scroll to the bottom of your Connect App's details page and click "Generate Connect Button HTML".

Testing the Authorization Workflow

With the Twilio Connect button now on your web site, browse to the page where you placed the HTML and click the Connect button. Verify that the information displayed on the authorization screen is correct.

After completing the app authorization process, you are redirected to the Authorize URL you specified when creating your Connect App. Appended to that URL is an AccountSid URL parameter with a value that looks like this:

http://www.example.com/twilio/authorize?AccountSid=AC12345
   Your Connect App's Authorize URL       Customer's SID

Your application should extract the AccountSid value from the URL and associate it with the user's account within your application. After extracting the AccountSid, we recommend that you redirect the user to another page within your app so the AccountSid isn't hanging around. For example, in this is the code required to access the AccountSid value and redirect to a new location:

authorize-callback.cshtml
@{
    string accountSid = Request["AccountSid"];
    // store accountSid value in database 
    // associated with a user in your application
    // redirect back to my app when done
    Response.Redirect("http://www.example.com/myapp", true);
}

Making an Authorized Request

With the user's AccountSid in hand you can now request data from their account via the Twilio REST API. A request to retrieve data from a user's account is nearly identical to a request made against your own account with only one key difference. Instead of authenticating with your AccountSid and AuthToken, you authenticate with the AccountSid retrieved during the authorization process and your account's AuthToken.

Here is a simple request to retrieve call logs from an account using a Twilio helper library. Pay special attention to line 4 where the customer's AccountSid is specified instead of your own:

authorized-request.cshtml
@Twilio;
@{
    string sid = "ACXXXXXX"; // The customer's AccountSid
    string token = "YYYYYY"; // Your account's AuthToken

    // create a new instance of the Twilio REST client
    var client = new TwilioRestClient(sid, token);

    // Get Recent Calls
    var calls = client.ListCalls();

    // Check for errors
    if (calls.RestException != null) 
    {
        Response.Write(string.Format("Error: {0}", calls.RestException.Message));
        Response.End();
    }    
}

Call Log

@foreach (var call in calls.Calls) {

Call from @call.From to @call.To at @call.StartTime of length @call.Duration

}

You're Done! Now What?

Retrieving call logs on behalf of your customers is just the start of what you can accomplish with Twilio Connect. Visit the complete Connect documentation and best practices to learn more about how to integrate Connect's additional capabilities into your applications.