REST API: Authorized Connect Apps

The AuthorizedConnectApps list resource shows all of the Connect Apps that you have authorized for your account. Each Connect App corresponds to a subaccount within your Twilio account, which acts as that Connect App's sandbox. The instance resource shows you the permissions you have granted for a Connect App as well as information about the Connect App itself.

AuthorizedConnectApp Instance Resource

Resource URI

/2010-04-01/Accounts/{AccountSid}/AuthorizedConnectApps/{ConnectAppSid}

Resource Properties

Property Description
DateCreated The date that this resource was created, given as GMT RFC 2822 format.
DateUpdated The date that this resource was last updated, given as GMT RFC 2822 format.
AccountSid The unique id of the SubAccount this Connect App has access to.
Permissions The set of permissions that you have authorized for this Connect App. Valid permisisons are get-all or post-all.
ConnectAppSid The unique id of the Connect App that was authorized.
ConnectAppFriendlyName A human readable name for the Connect App.
ConnectAppDescription A more detailed human readable description of the Connect App.
ConnectAppCompanyName The company name set for this Connect App.
ConnectAppHomepageUrl The public URL for this Connect App.
Uri The URI for this resource, relative to https://api.twilio.com.

HTTP GET

Example
instance-get-example-1
  • C#
  • Java
  • Node.js
  • PHP
  • Python
  • Ruby
  • curl
SDK Version:
  • 6.x
  • 7.x
SDK Version:
  • 4.x
  • 5.x
Response Format:
  • json
  • xml
// Install the Java helper library from twilio.com/docs/java/install
import com.twilio.sdk.TwilioRestClient;
import com.twilio.sdk.TwilioRestException;
import com.twilio.sdk.resource.instance.AuthorizedConnectApp;

public class Example { 

  // Find your Account Sid and Token at twilio.com/user/account
  public static final String ACCOUNT_SID = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
  public static final String AUTH_TOKEN = "your_auth_token";

  public static void main(String[] args) throws TwilioRestException {
    TwilioRestClient client = new TwilioRestClient(ACCOUNT_SID, AUTH_TOKEN);

    // Get an object from its sid. If you do not have a sid,
    // check out the list resource examples on this page
    AuthorizedConnectApp authorizedApp = client.getAccount().getAuthorizedConnectApp("CN47260e643654388faabe8aaa18ea6756");
    System.out.println(authorizedApp.getConnectAppHomepageUrl());
    
  }
}
$ curl -G https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/AuthorizedConnectApps/CN47260e643654388faabe8aaa18ea6756.json \
    -u 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token'
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/user/account
$sid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$token = "your_auth_token";
$client = new Client($sid, $token);

// Get an object from its sid. If you do not have a sid,
// check out the list resource examples on this page
$authorizedApp = $client
    ->authorizedConnectApps("CN47260e643654388faabe8aaa18ea6756")
    ->fetch();

echo $authorizedApp->connectAppHomepageUrl;
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once('/path/to/twilio-php/Services/Twilio.php'); // Loads the library

// Your Account Sid and Auth Token from twilio.com/user/account
$sid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; 
$token = "your_auth_token"; 
$client = new Services_Twilio($sid, $token);

// Get an object from its sid. If you do not have a sid,
// check out the list resource examples on this page
$authorized_app = $client->account->authorized_connect_apps->get("CN47260e643654388faabe8aaa18ea6756");
echo $authorized_app->connect_app_homepage_url;
$ curl -G https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/AuthorizedConnectApps/CN47260e643654388faabe8aaa18ea6756 \
    -u 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token'
// Download the twilio-csharp library from twilio.com/docs/csharp/install
using System;
using Twilio;
class Example
{
  static void Main(string[] args)
  {
    // Find your Account Sid and Auth Token at twilio.com/user/account
    string AccountSid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    string AuthToken = "your_auth_token";
    var twilio = new TwilioRestClient(AccountSid, AuthToken);

    var authorizedApp = twilio.GetAuthorizedConnectApp("CN47260e643654388faabe8aaa18ea6756");

    Console.WriteLine(authorizedApp.HomepageUrl);
  }
}
// Download the Node helper library from twilio.com/docs/node/install
// These vars are your accountSid and authToken from twilio.com/user/account
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var authToken = "your_auth_token";
var client = require('twilio')(accountSid, authToken);

client.authorizedConnectApps("CN47260e643654388faabe8aaa18ea6756").get(function(err, authorizedApp) {
    console.log(authorizedApp.connectAppHomepageUrl);
});
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import TwilioRestClient

# Your Account Sid and Auth Token from twilio.com/user/account
account_sid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
auth_token  = "your_auth_token"
client = TwilioRestClient(account_sid, auth_token)

authorized_app = client.authorized_connect_apps.get("CN47260e643654388faabe8aaa18ea6756")
print(authorized_app.homepage_url)
# Get twilio-ruby from twilio.com/docs/ruby/install
require 'rubygems'          # This line not needed for ruby > 1.8
require 'twilio-ruby'

# Get your Account Sid and Auth Token from twilio.com/user/account
account_sid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
auth_token = 'your_auth_token'
@client = Twilio::REST::Client.new account_sid, auth_token

# Get an object from its sid. If you do not have a sid,
# check out the list resource examples on this page
@authorized_app = @client.account.authorized_connect_apps.get("CN47260e643654388faabe8aaa18ea6756")
puts @authorized_app.connect_app_homepage_url
// Install the Java helper library from twilio.com/docs/java/install
import com.twilio.Twilio;
import com.twilio.rest.api.v2010.account.AuthorizedConnectApp;

public class Example {
  // Find your Account Sid and Token at twilio.com/user/account
  public static final String ACCOUNT_SID = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
  public static final String AUTH_TOKEN = "your_auth_token";

  public static void main(String[] args) {
    Twilio.init(ACCOUNT_SID, AUTH_TOKEN);

    // Get an object from its sid. If you do not have a sid,
    // check out the list resource examples on this page
    AuthorizedConnectApp authorizedApp =
        AuthorizedConnectApp.fetch("CN47260e643654388faabe8aaa18ea6756").execute();

    System.out.println(authorizedApp.getConnectAppHomepageUrl());
  }
}
Show Output
  • JSON
  • XML
{
  "connect_app_sid": "CN47260e643654388faabe8aaa18ea6756",
  "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "permissions": ["get-all", "post-all"],
  "connect_app_friendly_name": "My Connect App",
  "connect_app_description": null,
  "connect_app_company_name": "My Company",
  "connect_app_homepage_url": "http://www.mycompany.com"
}
<TwilioResponse>
	<AuthorizedConnectApp>
		<AccountSid>ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</AccountSid>
		<Permissions>
			<Permission>get-all</Permission>
			<Permission>post-all</Permission>
		</Permissions>
		<ConnectAppSid>CN47260e643654388faabe8aaa18ea6756</Sid>
		<ConnectAppFriendlyName>My Connect App</FriendlyName>
		<ConnectAppDescription>
			An amazing TwilioConnect application that does amazing things!
		</ConnectAppDescription>
		<ConnectAppCompanyName>My Company</CompanyName>
		<ConnectAppHomepageUrl>http://www.mycompany.com</HomepageUrl>
	</AuthorizedConnectApp>
</TwilioResponse>

HTTP POST

Not supported.

HTTP PUT

Not supported.

HTTP DELETE

Not supported.

AuthorizedConnectApps List Resource

Resource URI

/2010-04-01/Accounts/{AccountSid}/AuthorizedConnectApps

HTTP GET

Returns a list of Connect App resource representations, each representing a Connect App you've authorized to access your account. The list includes paging information.

Example 1
list-get-example-1
  • C#
  • Java
  • Node.js
  • PHP
  • Python
  • Ruby
  • curl
SDK Version:
  • 6.x
  • 7.x
SDK Version:
  • 4.x
  • 5.x
Response Format:
  • json
  • xml
// Install the Java helper library from twilio.com/docs/java/install
import com.twilio.sdk.TwilioRestClient;
import com.twilio.sdk.TwilioRestException;
import com.twilio.sdk.resource.instance.AuthorizedConnectApp;
import com.twilio.sdk.resource.list.AuthorizedConnectAppList;

public class Example { 

  // Find your Account Sid and Token at twilio.com/user/account
  public static final String ACCOUNT_SID = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
  public static final String AUTH_TOKEN = "your_auth_token";

  public static void main(String[] args) throws TwilioRestException {
    TwilioRestClient client = new TwilioRestClient(ACCOUNT_SID, AUTH_TOKEN);

    
    
    AuthorizedConnectAppList authorizedApps = client.getAccount().getAuthorizedConnectApps();
    
    // Loop over authorizedApps and print out a property for each one.
    for (AuthorizedConnectApp authorizedApp : authorizedApps) {
      System.out.println(authorizedApp.getConnectAppHomepageUrl());
    }
    
  }
}
$ curl -G https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/AuthorizedConnectApps.json \
    -u 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token'
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/user/account
$sid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$token = "your_auth_token";
$client = new Client($sid, $token);

// Loop over the list of authorized_apps and echo a property for each one
foreach ($client->authorizedConnectApps->read() as $authorizedApp) {
    echo $authorizedApp->connectAppHomepageUrl;
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once('/path/to/twilio-php/Services/Twilio.php'); // Loads the library

// Your Account Sid and Auth Token from twilio.com/user/account
$sid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; 
$token = "your_auth_token"; 
$client = new Services_Twilio($sid, $token);

// Loop over the list of authorized_apps and echo a property for each one
foreach ($client->account->authorized_connect_apps as $authorized_app) {
    echo $authorized_app->connect_app_homepage_url;
}
$ curl -G https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/AuthorizedConnectApps \
    -u 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token'
// Download the twilio-csharp library from twilio.com/docs/csharp/install
using System;
using Twilio;
class Example
{
  static void Main(string[] args)
  {
    // Find your Account Sid and Auth Token at twilio.com/user/account
    string AccountSid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    string AuthToken = "your_auth_token";
    var twilio = new TwilioRestClient(AccountSid, AuthToken);

    var authorizedApps = twilio.ListAuthorizedConnectApps(null, null);

    foreach (var authorizedApp in authorizedApps.AuthorizedConnectApps)
    {
      Console.WriteLine(authorizedApp.HomepageUrl);
    }
  }
}
// Download the Node helper library from twilio.com/docs/node/install
// These vars are your accountSid and authToken from twilio.com/user/account
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var authToken = "your_auth_token";
var client = require('twilio')(accountSid, authToken);

client.authorizedConnectApps.list(function(err, data) {
    data.authorizedConnectApps.forEach(function(authorizedApp) {
        console.log(authorizedApp.connectAppHomepageUrl);
    });
});
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import TwilioRestClient

# Your Account Sid and Auth Token from twilio.com/user/account
account_sid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
auth_token  = "your_auth_token"
client = TwilioRestClient(account_sid, auth_token)

# A list of authorized_app objects with the properties described above
authorized_apps = client.authorized_connect_apps.list()
# Get twilio-ruby from twilio.com/docs/ruby/install
require 'rubygems'          # This line not needed for ruby > 1.8
require 'twilio-ruby'

# Get your Account Sid and Auth Token from twilio.com/user/account
account_sid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
auth_token = 'your_auth_token'
@client = Twilio::REST::Client.new account_sid, auth_token


# Loop over authorized_apps and print out a property for each one
@client.account.authorized_connect_apps.list.each do |authorized_app|
    puts authorized_app.connect_app_homepage_url
end
// Install the Java helper library from twilio.com/docs/java/install
import com.twilio.Twilio;
import com.twilio.base.ResourceSet;
import com.twilio.rest.api.v2010.account.AuthorizedConnectApp;

public class Example {
  // Find your Account Sid and Token at twilio.com/user/account
  public static final String ACCOUNT_SID = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
  public static final String AUTH_TOKEN = "your_auth_token";

  public static void main(String[] args) {
    Twilio.init(ACCOUNT_SID, AUTH_TOKEN);

    ResourceSet<AuthorizedConnectApp> authorizedApps = AuthorizedConnectApp.read().execute();

    // Loop over authorizedApps and print out a property for each one.
    for (AuthorizedConnectApp authorizedApp : authorizedApps) {
      System.out.println(authorizedApp.getConnectAppHomepageUrl());
    }
  }
}
Show Output
  • JSON
  • XML
{
  "authorized_connect_apps": [
    {
      "connect_app_sid": "CNb989fdd207b04d16aee578018ef5fd93",
      "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "permissions": ["get-all", "post-all"],
      "connect_app_friendly_name": "Jenny Tracker",
      "connect_app_description": null,
      "connect_app_company_name": "Tommy PI",
      "connect_app_homepage_url": "http://www.tommypi.com"
    },
	...
  ],
  "page": 0,
  "page_size": 50,
  "uri": "\/2010-04-01\/Accounts\/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\/AuthorizedConnectApps\/.json",
  "first_page_uri": "\/2010-04-01\/Accounts\/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\/AuthorizedConnectApps\/.json?Page=0&PageSize=50",
  "previous_page_uri": null,
  "next_page_uri": null,
}
<TwilioResponse>
  <AuthorizedConnectApps page="0" pagesize="50" uri="/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/AuthorizedConnectApps/" firstpageuri="/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/AuthorizedConnectApps/?Page=0&PageSize=50" previouspageuri=""nextpageuri="">
    <AuthorizedConnectApp>
      <ConnectAppSid>CNb989fdd207b04d16aee578018ef5fd93</ConnectAppSid>
      <AccountSid>ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</AccountSid>
	  <Permissions>
	    <Permission>get-all</Permission>
	    <Permission>post-all</Permission>
	  </Permissions>
      <ConnectAppFriendlyName>Jenny Tracker</ConnectAppFriendlyName>
      <ConnectAppDescription/>
      <ConnectAppCompanyName>Tommy PI</ConnectAppCompanyName>
      <ConnectAppHomepageUrl>http://www.tommypi.com</ConnectAppHomepageUrl>
    </AuthorizedConnectApp>
    ...
  </AuthorizedConnectApps>
</TwilioResponse>

HTTP POST

Not Supported.

HTTP PUT

Not Supported.

HTTP DELETE

Not Supported.