This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Twilio Connector

Owned by Former user (Deleted)
Last updated: Oct 20, 2016 by Former user (Deleted)
29 min read

The Twilio connector allows you to connect to Twilio, an online service that lets you embed phones, VoIP, and messaging in web, desktop, and mobile software. The connector uses the Twilio REST API to connect to Twilio and work with accounts, applications, calls, messages, and more. The underlying Java classes in the connector use the Twilio Java Helper Library to make the HTTP requests to the Twilio API.

The following sections describe how to perform various operations with the connector. For general information on using connectors and their operations in your ESB configurations, see Using a Connector. To download the connector, go to https://store.wso2.com/store/assets/esbconnector/twilio, click the Twilio connector, and then click Download Connector. Then you can add and enable the connector in your ESB instance.

Connecting to Twilio

To use the Twilio connector, add the <twilio.init> element in your configuration before any other Twilio operations. This Twilio configuration authenticates with Twilio by specifying the SID and authentication token of your master Twilio account. You can find your SID and token by logging into your Twilio account and going to the API Credentials section on the dashboard.

init
<twilio.init>
    <accountSid>ACba8bc05eacf94afdae398e642c9cc32d</accountSid>
    <authToken>AC5ef8732a3c49700934481addd5ce1659:{AuthToken}</authToken>
</twilio.init>
Entering secure data

For security purposes, you should store your SID and token in the WSO2 secure vault and reference it by alias instead of hard-coding the actual values in the configuration file. For more information, see Working with Passwords.

Re-using Twilio configurations

For best results, save the Twilio configuration as a local entry. You can then easily reference it with the configKey attribute in your Twilio operations. For example, if you saved the above <twilio.init> entry as a local entry named MyTwilioConfig, you could reference it from an operation like getTranscriptionList as follows:

<twilio.getTranscriptionList configKey="MyTwilioConfig" />

 

Working with accounts

The following operations are available for working with accounts:

OperationDescription
createSubAccountCreates a new account resource as a sub-account of the master account.
getAccountsListRetrieves a list of the account resources belonging to the master account. This list will include the master account as well.
getAccountReturns a representation of a specified account.
updateAccountAllows you to modify the properties of an account.

Following is more information about these operations.

Creating a sub-account

createSubAccount
<twilio.createSubAccount configKey="MyTwilioConfig">
    <friendlyName>My New Account</friendlyName>
</twilio.createSubAccount>

To create a sub-account as a resource of the master account, use twilio.createSubAccount and specify the following properties. If successful, Twilio responds with information about the sub-account, including its SID, a 34-character string that uniquely identifies this sub-account.

Properties
  • friendlyName: A human-readable description of the new sub-account, up to 64 characters. Defaults to "SubAccount Created at {YYYY-MM-DD HH:MM meridian}".
Related Twilio documentation

http://www.twilio.com/docs/api/rest/subaccounts

Getting a list of accounts

getAccountsList
<twilio.getAccountsList configKey="MyTwilioConfig">
    <friendlyName>My SubAccount</friendlyName>
    <status>active</status>
</twilio.getAccountsList>

To get a list of existing accounts that belong to the master account, use twilio.getAccountsList and optionally specify the following properties. If you do not specify these properties, all accounts belong to the master account are returned. The master account is included in the list.

Properties
  • friendlyName: Optional. The human-readable account name. Only accounts whose name exactly match this string are returned.
  • status: Optional. The status of accounts to return: active, suspended, or closed. Only accounts with this status are returned.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/account#list

Getting a specific account

getAccount
<twilio.getAccount configKey="MyTwilioConfig">
    <subAccountSid>ACba8bc05eacf94afdae398e642c9cc32d</subAccountSid>
</twilio.getAccount>

To get information about an account, such as its friendly name, date created, and status, use twilio.getAccount and specify the following properties. 

Properties
  • subAccountSid: The ID of the account you want to retrieve.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/account

Updating an account

updateAccount
<twilio.updateAccount configKey="MyTwilioConfig">
    <subAccountSid>ACba8bc05eacf94afdae398e642c9cc32d</subAccountSid>
    <friendlyName>MySubAccount</friendlyName>
    <status>suspended</status>
</twilio.updateAccount>

To update an account's friendly name and/or status, use twilio.updateAccount and specify the following properties. 

Properties
  • subAccountSid: The ID of the account you want to update.
  • friendlyName: Optional. The new human-readable name to give the account.
  • status: Optional. The new status of the account: active, suspended, or closed.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/account

Working with applications

The following operations are available for working with applications and Connect Apps in your Twilio account:

OperationDescription
createApplicationCreates a new application.
getApplicationListRetrieves a list of all the applications you've created in the master account.
getApplicationReturns information about a specific application.
getConnectAppListRetrieves a list of all the Connect Apps you've created in the master account.
getConnectAppReturns information about a specific Connect App.
getAuthorizedConnectAppListRetrieves a list of the Connect Apps that are authorized to access your account.
getAuthorizedConnectAppReturns information about a specific authorized Connect App.
updateApplicationUpdates the properties of an application.
updateConnectAppUpdates the properties of a Connect App.
removeApplicationDeletes an application. If this application's SID is assigned to any IncomingPhoneNumber resources as a VoiceApplicationSid or SmsApplicationSid, it will be removed from those resources.

Following is more information about these operations.

Creating an application

createApplication
<twilio.createApplication configKey="MyTwilioConfig">
    <friendlyName>Phone Me</friendlyName>
    <apiVersion>2010-04-01</apiVersion>
    <voiceUrl>http://demo.twilio.com/docs/voice.xml</voiceUrl>
    <voiceMethod>POST</voiceMethod>
    <voiceFallbackUrl>http://demo.twilio.com/docs/voicefallback.xml</voiceFallbackUrl>
    <voiceFallbackMethod>POST</voiceFallbackMethod>
    <statusCallback>http://demo.twilio.com/docs/statuscallback.xml</statusCallback>
    <statusCallbackMethod>POST</statusCallbackMethod>
    <voiceCallerIdLookup>false</voiceCallerIdLookup>
    <smsUrl>http://demo.twilio.com/docs/sms.xml</smsUrl>
    <smsMethod>POST</smsMethod>
    <smsFallbackUrl>http://demo.twilio.com/docs/smsfallback.xml</smsFallbackUrl>
    <smsFallbackMethod>POST</smsFallbackMethod>
    <smsStatusCallback>http://demo.twilio.com/docs/smsstatuscallback.xml</smsStatusCallback>
</twilio.createApplication>

To create an application in the master account, use twilio.createApplication and specify the following properties. If successful, Twilio responds with a representation of the application, including its SID, a 34-character string that uniquely identifies this application. You must specify voiceUrl or smsUrl or both.

Properties
  • friendlyName: The human-readable name to give the application, up to 64 characters.
  • apiVersion: Optional. Specifies the API version, either 2010-04-01 or 2008-08-01, to use when requests to the application's URLs are received. Defaults to your account's default API version.
  • voiceUrl: Optional. The URL that Twilio should request when somebody dials a phone number assigned to this application. Not required if your application does not support voice.
  • voiceMethod: Optional. The HTTP method, either GET or POST, that should be used to request the voice URL. Defaults to POST.
  • voiceFallbackUrl: Optional. A URL that Twilio will request if an error occurs when requests are made to the voice URL.
  • voiceFallbackMethod: Optional. The HTTP method, either GET or POST, that should be used to request the voice fallback URL. Defaults to POST.
  • statusCallback: Optional. The URL that Twilio will request to pass status parameters (such as call ended) to your application.
  • statusCallbackMethod: Optional. The HTTP method, either GET or POST, that should be used to request the status callback URL. Defaults to POST.
  • voiceCallerIdLookup: Optional. If true, performs a lookup of the caller's name from the CNAM database and posts it to your app. Defaults to false.
  • smsUrl: Optional. The URL that Twilio should request when somebody sends an SMS to a phone number assigned to this application. Not required if your application does not support SMS.
  • smsMethod: Optional. The HTTP method, either GET or POST, that should be used to request the SMS URL. Defaults to POST.
  • smsFallbackUrl: Optional. The URL that Twilio will request if an error occurs when requests are made to the SMS URL.
  • smsFallbackMethod: Optional. The HTTP method, either GET or POST, that should be used to request the SMS fallback URL. Defaults to POST.
  • smsStatusCallback: Optional. Twilio will make a POST request to this URL to pass status parameters (such as sent or failed) to your application if you specify this application's SID as the ApplicationSid on an outgoing SMS request.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/applications

Getting a list of applications

getApplicationList
<twilio.getApplicationList configKey="MyTwilioConfig">
    <friendlyName>Phone Me</friendlyName>
</twilio.getApplicationList>

To get a list of the applications in the master account, use twilio.getApplicationList and specify the following properties.

Properties
  • friendlyName: Optional. The human-readable application name. Only applications whose name exactly match this string are returned.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/applications

Getting a specific application

getApplication
<twilio.getApplication configKey="MyTwilioConfig">
    <applicationSid>AP2a0747eba6abf96b7e3c3ff0b4530f6e</applicationSid>
</twilio.getApplication>

To get a specific application from the master account, use twilio.getApplication and specify the following properties.

Properties
  • applicationSid: The 32-character string that uniquely identifies the account.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/applications

Getting a list of Connect Apps

getConnectAppList
<twilio.getConnectAppList configKey="MyTwilioConfig />

To get a list of the Connect Apps created in the master account, including the permissions each Connect App will request from users, use twilio.getConnectAppList.

Related Twilio documentation

http://www.twilio.com/docs/api/rest/connect-apps

Getting a specific Connect App

getConnectApp
<twilio.getConnectApp configKey="MyTwilioConfig">
    <connectAppSid>CNb989fdd207b04d16aee578018ef5fd93</connectAppSid>
</twilio.getConnectApp>

To get the properties of a specific Connect App, use twilio.getConnectApp and specify the following properties.

Properties
  • connectAppSid: SID of the Connect App.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/connect-apps

Getting a list of authorized Connect Apps

getAuthorizedConnectAppList
<twilio.getAuthorizedConnectAppList configKey="MyTwilioConfig />

To get a list of the Connect Apps that are authorized for your account, use twilio.getAuthorizedConnectAppList.

Related Twilio documentation

http://www.twilio.com/docs/api/rest/authorized-connect-apps

Getting a specific authorized Connect App

getAuthorizedConnectApp
<twilio.getAuthorizedConnectApp configKey="MyTwilioConfig">
    <authorizedConnectAppSid>AC5ef872f6da5a21de157d80997a64bd33</authorizedConnectAppSid>
</twilio.getAuthorizedConnectApp>

To get the properties of a specific authorized Connect App, including the permissions you have granted it, use twilio.getAuthorizedConnectApp and specify the following properties.

Properties
  • authorizedConnectAppSid: SID of the authorized Connect App.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/connect-apps

Updating an application

updateApplication
<twilio.updateApplication configKey="MyTwilioConfig">
    <applicationSid>AP2a0747eba6abf96b7e3c3ff0b4530f6e</applicationSid>
    <friendlyName>Phone Me</friendlyName>
    <apiVersion>2010-04-01</apiVersion>
    <voiceUrl>http://demo.twilio.com/docs/voice.xml</voiceUrl>
    <voiceMethod>POST</voiceMethod>
    <voiceFallbackUrl>http://demo.twilio.com/docs/voicefallback.xml</voiceFallbackUrl>
    <voiceFallbackMethod>POST</voiceFallbackMethod>
    <statusCallback>http://demo.twilio.com/docs/statuscallback.xml</statusCallback>
    <statusCallbackMethod>POST</statusCallbackMethod>
    <voiceCallerIdLookup>false</voiceCallerIdLookup>
    <smsUrl>http://demo.twilio.com/docs/sms.xml</smsUrl>
    <smsMethod>POST</smsMethod>
    <smsFallbackUrl>http://demo.twilio.com/docs/smsfallback.xml</smsFallbackUrl>
    <smsFallbackMethod>POST</smsFallbackMethod>
    <smsStatusCallback>http://demo.twilio.com/docs/smsstatuscallback.xml</smsStatusCallback>
</twilio.updateApplication>

To update the properties of an application, use twilio.updateApplication, specify the application's SID, and then specify the properties you want to update. If successful, Twilio responds with a representation of the application.

Properties
  • applicationSid: The SID of the application you are updating.
  • friendlyName: Optional. The human-readable name of the application, up to 64 characters.
  • apiVersion: Optional. Specifies the API version, either 2010-04-01 or 2008-08-01, to use when requests to the application's URLs are received. Defaults to your account's default API version.
  • voiceUrl: The URL that Twilio should request when somebody dials a phone number assigned to this application. Not required if your application does not support voice.
  • voiceMethod: Optional. The HTTP method, either GET or POST, that should be used to request the voice URL. Defaults to POST.
  • voiceFallbackUrl: Optional. A URL that Twilio will request if an error occurs when requests are made to the voice URL.
  • voiceFallbackMethod: Optional. The HTTP method, either GET or POST, that should be used to request the voice fallback URL. Defaults to POST.
  • statusCallback: Optional. The URL that Twilio will request to pass status parameters (such as call ended) to your application.
  • statusCallbackMethod: Optional. The HTTP method, either GET or POST, that should be used to request the status callback URL. Defaults to POST.
  • voiceCallerIdLookup: Optional. If true, performs a lookup of the caller's name from the CNAM database and posts it to your app. Defaults to false.
  • smsUrl: The URL that Twilio should request when somebody sends an SMS to a phone number assigned to this application. Not required if your application does not support SMS.
  • smsMethod: Optional. The HTTP method, either GET or POST, that should be used to request the SMS URL. Defaults to POST.
  • smsFallbackUrl: Optional. The URL that Twilio will request if an error occurs when requests are made to the SMS URL.
  • smsFallbackMethod: Optional. The HTTP method, either GET or POST, that should be used to request the SMS fallback URL. Defaults to POST.
  • smsStatusCallback: Optional. Twilio will make a POST request to this URL to pass status parameters (such as sent or failed) to your application if you specify this application's SID as the ApplicationSid on an outgoing SMS request.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/applications

Updating a Connect App

updateConnectApp
<twilio.updateConnectApp configKey="MyTwilioConfig">
    <connectAppSid>CNb989fdd207b04d16aee578018ef5fd93</connectAppSid>
    <friendlyName>My Connect App</friendlyName>
    <authorizeCallbackUrl>https://www.mycompany.com/connect_authorize</authorizeCallbackUrl>
    <deauthorizeRedirectUrl>https://www.mycompany.com/connect_deauthorize</deauthorizeRedirectUrl>
    <deauthorizeCallbackMethod>POST</deauthorizeCallbackMethod>
    <permissions>get-all,post-all</permissions>
    <description>Connects to my company's Twilio account</description>
    <companyName>My Company</companyName>
    <homepageUrl>http://www.mycompany.com</homepageUrl>
</twilio.updateConnectApp>

To update the properties of a Connect App, use twilio.updateConnectApp, specify the Connect Apps' SID, and then specify the properties you want to update. If successful, Twilio responds with a representation of the application.

Properties
  • connectAppSid: The SID of the Connect App you are updating.
  • friendlyName: Optional. The human-readable name of the Connect App, up to 64 characters.

  • authorizeCallbackUrl: Optional. The URL the user's browser will redirect to after Twilio authenticates the user and obtains authorization for this Connect App.

  • deauthorizeRedirectUrl: The URL to which Twilio will send a request when a user de-authorizes this Connect App.

  • deauthorizeCallbackMethod: Optional. The HTTP method, either GET or POST, that should be used to request the deauthorize callback URL. 

  • permissions: Optional. A comma-separated list of the permissions you will request from users of this Connect App. Valid permissions are get-all and post-all.
  • description: Optional. A more detailed human-readable description of this Connect App,.
  • companyName: Optional. The company name for this Connect App.
  • homepageUrl: Optional. The public URL where users can obtain more information about this Connect App.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/connect-apps

Removing an application

removeApplication
<twilio.removeApplication configKey="MyTwilioConfig">
    <applicationSid>AP2a0747eba6abf96b7e3c3ff0b4530f6e</applicationSid>
</twilio.removeApplication>

To remove an application from the master account, use twilio.removeApplication and specify the following properties.

Properties
  • applicationSid: The SID of the application you are removing.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/applications

Working with calls

The following operations are available for working with calls, recordings, and transcriptions.

OperationDescription
makeCall

Makes an outgoing call to a phone, SIP-enabled endpoint, or Twilio Client connection. Calls are rate-limited to one per second. You can queue up as many calls as you like as fast as you like, but each call is processed off the queue at a rate of one per second.

getCallListReturns a list of calls made to and from your account.
getCallRetrieves information about a specific call.
modifyLiveCallChanges the behavior of an in-progress call, such as transferring the call, playing hold music, or terminating the call.
getRecordingListReturns a list of recordings in your account.
getRecordingRetrieves a specific recording.
deleteRecordingDeletes a recording.
getTranscriptionListReturns a list of transcriptions of recordings in your account.
getTranscriptionRetrieves a specific transcription of a recording.

Following is more information about these operations.

Making a call

makeCall
<twilio.makeCall configKey="MyTwilioConfig">
    <to>%2B14155551212</to>
    <from>%2B18668675309</from>
    <url>http://demo.twilio.com/docs/voice.xml</url>
    <method>POST</method>
    <fallbackUrl>http://demo.twilio.com/docs/voicefallback.xml</fallbackUrl>
    <fallbackMethod>POST</fallbackMethod>
    <statusCallback>http://demo.twilio.com/docs/statuscallback.xml</statusCallback>
    <statusCallbackMethod>GET</statusCallbackMethod>
    <sendDigits>ww1234%23</sendDigits>
    <ifMachine>Continue</ifMachine>
    <timeout>60</timeout>
    <record>false</record>
</twilio.makeCall>

To make a call, use twilio.makeCall and specify the following properties. For more information on formatting phone numbers, see http://www.twilio.com/docs/api/rest/making-calls#post-parameters-required.

Properties
  • to: The phone number, SIP address, or client identifier to call. For more information on SIP, see http://www.twilio.com/docs/sip.
  • from: The phone number or client identifier to use as the caller ID. If using a phone number, it must be a Twilio number or a verified outgoing caller ID for your account.
  • applicationSid: The 34-character string that uniquely identifies the application that defines the properties to use for making the call. If you use this property, the following voice properties will be ignored, because they are already defined by the application: url, method, fallbackUrl, fallbackMethod, statusCallback, and statusCallbackMethod.
  • url: The fully qualified URL that should be consulted when the call connects. This property is ignored if you specify an applicationSid.
  • method: Optional. The HTTP method, GET or POST, to use when connecting to the URL. Defaults to POST. This property is ignored if you specify an applicationSid.
  • fallbackUrl: Optional. A URL that Twilio will request if an error occurs when requests are made to the URL.This property is ignored if you specify an applicationSid.
  • fallbackMethod: Optional. The HTTP method, either GET or POST, that should be used to request the fallback URL. Defaults to POST. This property is ignored if you specify an applicationSid.
  • statusCallback: Optional. The URL that Twilio will request when the call ends to notify your application. This property is ignored if you specify an applicationSid.
  • statusCallbackMethod: Optional. The HTTP method, either GET or POST, that should be used to request the status callback URL. Defaults to POST. This property is ignored if you specify an applicationSid.

  • sendDigits: Optional. A string of keys to dial after connecting to the number. Valid digits in the string include: any digit (0-9), %23 (the URL-encoded version of #), *, and w (to insert a half-second pause). For example, if you are connecting to a company phone number and want to pause for one second, dial extension 1234, and then the pound key, use <sendDigits>ww1234%23</sendDigits>. 

  • ifMachine: Optional. Specifies whether Twilio should try to determine whether a machine (like voicemail) or a human has answered the call. Possible values are Continue and Hangup. For more information, see http://www.twilio.com/docs/api/rest/making-calls#handling-outcomes-answering-machines.
  • timeout: Optional. The integer number of seconds that Twilio should allow the phone to ring before assuming there is no answer. Default is 60 seconds, the maximum is 999 seconds. Note, you could set this to a low value, such as 15, to hangup before reaching an answering machine or voicemail.
  • record: Optional. Specifies whether to record the call. If true, the entire call is recorded, and the recording URL is sent to the status callback URL. Defaults to false.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/making-calls

Getting a list of calls

getCallList
<twilio.getCallList configKey="MyTwilioConfig">
    <to>2B14155551212</to>
    <from>2B18668675309</from>
    <status>completed</status>
    <startTime>2013-09-30</startTime>
    <parentCallSid>CAe1644a7eed5088b159577c5802d8be38</parentCallSid>
</twilio.getCallList>

To get a list of calls, use twilio.getCallList and specify the following properties.

Properties
  • to: Optional. Only get calls made to this phone number, SIP address, or client identifier.
  • from: Optional. Only get calls made from this phone number or client identifier.
  • status: Optional. Only get calls currently in this status. May be queued, ringing, in-progress, canceled, completed, failed, busy, or no-answer.

  • startTime: Optional. Only get calls that started on this date, given as YYYY-MM-DD. Also supports inequalities, such as <=YYYY-MM-DD for calls that started at or before midnight on a date, and >=YYYY-MM-DD for calls that started at or after midnight on a date.

  • parentCallSid: Optional. Only get calls spawned by the call with this SID.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/call

Getting a specific call

getCall
<twilio.getCall configKey="MyTwilioConfig">
    <callSid>CAe1644a7eed5088b159577c5802d8be38</callSid>
</twilio.getCall>

To get information about a specific call, including start time, end time, and more, use twilio.getCall and specify the following properties.

Properties
  • callSid: The identifier of the call you want to get.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/call

Modifying a live call

modifyLiveCall
<twilio.modifyLiveCall configKey="MyTwilioConfig">
    <callSid>CAe1644a7eed5088b159577c5802d8be38</callSid>
    <url>http://demo.twilio.com/docs/voice.xml</url>
    <method>POST</method>
	<status>completed</status>
    <fallbackUrl>http://demo.twilio.com/docs/voicefallback.xml</fallbackUrl>
    <fallbackMethod>POST</fallbackMethod>
    <statusCallback>http://demo.twilio.com/docs/statuscallback.xml</statusCallback>
    <statusCallbackMethod>GET</statusCallbackMethod>
</twilio.modifyLiveCall>

To interrupt an in-progress call and terminate it or process it using a new URL, use twilio.modifyLiveCall and specify the following properties.

Properties
  • callSid: The identifier of the call you want to modify.
  • url: The fully qualified URL where the call should be redirected.
  • method: Optional. The HTTP method, GET or POST, to use when connecting to the URL. Defaults to POST. 

  • status: Optional. Either canceled or completed. Specifying canceled will attempt to hang up calls that are queued or ringing but not affect calls already in progress. Specifying completed will attempt to hang up a call even if it's already in progress.

  • fallbackUrl: Optional. A URL that Twilio will request if an error occurs when requests are made to the URL.
  • fallbackMethod: Optional. The HTTP method, either GET or POST, that should be used to request the fallback URL. Defaults to POST.
  • statusCallback: Optional. The URL that Twilio will request when the call ends to notify your application.
  • statusCallbackMethod: Optional. The HTTP method, either GET or POST, that should be used to request the status callback URL. Defaults to POST.
Related Twilio documentation

http://www.twilio.com/docs/api/rest/change-call-state

Getting a list of recordings

getRecordingList
<twilio.getRecordingList configKey="MyTwilioConfig">
    <callSid>CAe1644a7eed5088b159577c5802d8be38</callSid>
    <dateCreated>2013-09-30</dateCreated>
</twilio.getRecordingList>

To get a list of recordings, use twilio.getRecordingList and specify the following properties.

Properties
  • callSid: Optional. Only get recordings made during the call given by this SID.

  • dateCreated: Optional. Only get recordings created on this date, given as YYYY-MM-DD. Also supports inequalities, such as <=YYYY-MM-DD for recordings generated at or before midnight on a date, and >=YYYY-MM-DD for recordings generated at or after midnight on a date.

Related Twilio documentation

http://www.twilio.com/docs/api/rest/recording#list

Getting a specific recording

getRecording