Twilio (version v1.*.*)

add_credential_to_list

Add a Credential to the CredentialList.

When creating a Credential, you will POST both a username and password, but only receive the username back in the response. The password is intentionally not returned so as to protect it.

Parameters

AccountSid (required)

Type: string

CLSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

add_incoming_phone_number_local

Adds a new phone number to your account. If a phone number is found for your request, Twilio will add it to your account and bill you for the first month's cost of the phone number.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

Type: string

add_incoming_phone_number_mobile

Adds a new phone number to your account. If a phone number is found for your request, Twilio will add it to your account and bill you for the first month's cost of the phone number.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

Type: string

add_incoming_phone_number_tollfree

Adds a new phone number to your account. If a phone number is found for your request, Twilio will add it to your account and bill you for the first month's cost of the phone number.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

Type: string

add_ip_address_to_list

Add an IP Address to the list with a description.

Parameters

AccountSid (required)

Type: string

IpAccessControlListSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

add_outgoing_caller_id

Adds a new CallerID to your account.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

change_password_for_credential

Change the password of a Credential record.

If the change is successful, Twilio will respond with the Credential record but will not include the password in the response.

Parameters

AccountSid (required)

Type: string

CLSid (required)

Type: string

CredentialSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

create_account

Create a new Account instance resource as a subaccount of the one used to make the request. See Creating Subaccounts for more information.

Parameters

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

create_app

Creates a new application within your account.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

create_credential_list

Create a new Credential List.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

create_credential_list_mapping

Map a CredentialList to the domain.

Parameters

AccountSid (required)

Type: string

SipDomainSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

create_domain

Creates a new Domain and returns its instance resource. You must pick a unique domain name that ends in ".sip.twilio.com". After creating a Domain, you must map it to an authentication method before the domain is ready to receive traffic.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

create_incoming_phone_number

Purchases a new phone number for your account. If a phone number is found for your request, Twilio will add it to your account and bill you for the first month's cost of the phone number. To find an available phone number to POST, use the subresources of the AvailablePhoneNumbers list resource.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

create_ip_access_control_list

Create a new IpAccessControlList resource.

When created, the list will contain no IP addresses. You will need to add IP addresses to the list for it to be active. To add IP addresses, you will need to POST to the IpAddresses List subresource.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

Type: string

create_ip_access_control_list_mapping

Map an IpAccessControlList to this domain.

Parameters

AccountSid (required)

Type: string

SipDomainSid (required)

Type: string

mediaTypeExtension (required)

Type: string

create_queue

Create a new Queue resource.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

create_usage_trigger

Creates a new UsageTrigger. Each account can create up to 1,000 UsageTriggers. Currently, UsageTriggers that are no longer active are not deleted automatically. Use DELETE to delete triggers you no longer need.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

delete_application

Delete this application.

Parameters

AccountSid (required)

Type: string

ApplicationSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

delete_credential_from_list

Remove a Credential from a CredentialList.

Parameters

AccountSid (required)

Type: string

CLSid (required)

Type: string

CredentialSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

delete_credential_list

Delete a CredentialList from your account. It can only be deleted if no domains are mapped to it. If you attempt to delete one that is mapped to a domain, you will receive an error.

Parameters

AccountSid (required)

Type: string

CLSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

delete_credential_list_mapping

Remove a CredentialListMapping from a domain

Parameters

AccountSid (required)

Type: string

CLSid (required)

Type: string

SipDomainSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

delete_domain

Delete a domain. If you have created subdomains of a domain, you will not be able to delete the domain until you first delete all subdomains of it.

Parameters

AccountSid (required)

Type: string

SipDomainSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

delete_ip_access_control_list

Delete an IpAccessControlList from your account. It can only be deleted if no domains are mapped to it. If you attempt to delete one that is mapped to a domain, you will receive an error.

Parameters

AccountSid (required)

Type: string

IpAccessControlListSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

delete_ip_access_control_list_mapping

Remove a mapping from this domain.

Parameters

ALSid (required)

Type: string

AccountSid (required)

Type: string

SipDomainSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

delete_ip_address_from_list

Deletes an IP address entry from the list.

Parameters

AccountSid (required)

Type: string

IpAccessControlListSid (required)

Type: string

IpAddressSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

delete_notification

Deletes the notification identified by {NotificationSid} from an account's log.

Parameters

AccountSid (required)

Type: string

NotificationSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

delete_outgoing_caller_id

Deletes the caller ID from the account. Returns an HTTP 204 response if successful, with no body.

Parameters

AccountSid (required)

Type: string

OutgoingCallerIdSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

delete_queue

The DELETE method allows you to remove a Queue. Only empty queues are deletable.

Parameters

AccountSid (required)

Type: string

QueueSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

delete_recording

Deletes a recording from your account.

Parameters

AccountSid (required)

Type: string

RecordingSid (required)

Type: string

mediaTypeExtension (required)

Type: string

Potential values: .xml, .wav, .mp3

delete_transcription

Deletes a transcription from your account.

Parameters

AccountSid (required)

Type: string

TranscriptionSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html, .txt, .xml

delete_usage_trigger

Delete this UsageTrigger.

Parameters

AccountSid (required)

Type: string

UsageTriggerSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

dequeue_front_member_of_queue

Posting a URL and Method to a Queue instance will dequeue a member from a queue and have the member's call begin executing the TwiML document at that URL When dequeuing the 'Front' of the queue, the next call in the queue will be redirected.

Parameters

AccountSid (required)

Type: string

QueueSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

dequeue_member_of_queue

Posting a URL and Method to a Queue instance will dequeue a member from a queue and have the member's call begin executing the TwiML document at that URL When redirecting a member of a queue addressed by CallSid, only the first request will succeed and return a 200 response code. A second request will fail and return an appropriate 400 response code.

Parameters

AccountSid (required)

Type: string

CallSid (required)

Type: string

QueueSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_account

Returns a representation of an account.

Parameters

AccountSid (required)

A 34 character string that uniquely identifies this account.

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_app_properties

Get the properties of the authorized application.

Parameters

AccountSid (required)

Type: string

ConnectAppSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_application

Get application instance resource.

Parameters

AccountSid (required)

Type: string

ApplicationSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_call

Returns the single Call resource identified by {CallSid}.

Parameters

AccountSid (required)

Type: string

CallSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_conference

Returns a representation of the conference identified by {ConferenceSid}.

Parameters

AccountSid (required)

Type: string

ConferenceSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_connect_app_properties

Get the properties of a Connect App.

Parameters

AccountSid (required)

Type: string

ConnectAppSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_credential_in_list

Get a specific Credential in a list. Though a password is stored for each username in your list, the password is not returned to protect your password. If you cannot remember your password, you will need to POST to this resource to update it.

Parameters

AccountSid (required)

Type: string

CLSid (required)

Type: string

CredentialSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_credential_list

Get a credential list instance resource

Parameters

AccountSid (required)

Type: string

CLSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_domain

Return a specific instance by Sid.

Parameters

AccountSid (required)

Type: string

SipDomainSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_front_member_of_queue

Get a front member.

Parameters

AccountSid (required)

Type: string

QueueSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_incoming_phone_number

Get info about incoming call's phone number.

Parameters

AccountSid (required)

Type: string

IncomingPhoneNumberSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_ip_access_control_list

Return a specific IpAccessControlList resource.

Parameters

AccountSid (required)

Type: string

IpAccessControlListSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_ip_access_control_list_mapping

Return a specific IpAccessControlListMapping instance by Sid.

Parameters

ALSid (required)

Type: string

AccountSid (required)

Type: string

SipDomainSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_ip_address_from_list

Return a single IP Address resource.

Parameters

AccountSid (required)

Type: string

IpAccessControlListSid (required)

Type: string

IpAddressSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_media_for_message

Without an extension, the media is returned using the mime-type provided when the media was generated.

Parameters

AccountSid (required)

Type: string

MediaSid (required)

Type: string

MessageSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_member_of_queue

Get a specific member.

Parameters

AccountSid (required)

Type: string

CallSid (required)

Type: string

QueueSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_message

Returns a single message specified by the provided {MessageSid}.

Parameters

AccountSid (required)

Type: string

MessageSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_notification

Get a notification entry.

Parameters

AccountSid (required)

Type: string

NotificationSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_outgoing_caller_id

Get Outgoing Caller ID Details

Parameters

AccountSid (required)

Type: string

OutgoingCallerIdSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_participant

Returns a representation of this participant.

Parameters

AccountSid (required)

Type: string

CallSid (required)

Type: string

ConferenceSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_queue

Get resource's individual Queue instance.

Parameters

AccountSid (required)

Type: string

QueueSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_recording

Returns one of several representations: Without an extension, or with a ".wav", a binary WAV audio file is returned with mime-type "audio/x-wav". Appending ".mp3" to the URI returns a binary MP3 audio file with mime-type type "audio/mpeg". Appending ".xml" to the URI returns a XML representation.

Parameters

AccountSid (required)

Type: string

RecordingSid (required)

Type: string

mediaTypeExtension (required)

Type: string

Potential values: .xml, .wav, .mp3

get_shortcode

Get a single shortcode.

Parameters

AccountSid (required)

Type: string

ShortCodeSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

get_transcription

Returns a single Transcription resource representation identified by the given {TranscriptionSid}. By default Twilio will respond with the XML metadata for the Transcription. If you append ".txt" to the end of the Transcription resource's URI Twilio will just return you the transcription tex.

Parameters

AccountSid (required)

Type: string

TranscriptionSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html, .txt, .xml

get_usage_trigger

Returns a repesentation of the UsageTrigger.

Parameters

AccountSid (required)

Type: string

UsageTriggerSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_accounts

Retrieve a list of the Account resources belonging to the account used to make the API request. This list will include that Account as well.

Parameters

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_all_usage_records

Returns UsageRecords for all usage categories. The list includes paging information. By default, the UsageRecords resource will return one UsageRecord for each Category, representing all usage accrued all-time for the account. You can filter the usage Category or change the date-range over which usage is counted using optional GET query parameters.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_app_resources

Returns a list of Application resource representations, each representing an application within your account. The list includes paging information.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_available_phone_numbers

Returns a list of all AvailablePhoneNumber subresources for your account by ISO Country. For full information about our phone number support, see our Phone Number CSV (http://www.twilio.com/resources/rates/international-phone-number-rates.csv).

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_available_phone_numbers_local

Returns a list of local AvailablePhoneNumber resource representations that match the specified filters, each representing a phone number tha is currently available for provisioning within your account.

Parameters

AccountSid (required)

Type: string

IsoCountryCode (required)

ISO 3166-1 alpha-2.

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_available_phone_numbers_mobile

Returns a list of mobile AvailablePhoneNumber resource representations that match the specified filters, each representing a phone number that is currently available for provisioning within your account.

Parameters

AccountSid (required)

Type: string

IsoCountryCode (required)

ISO 3166-1 alpha-2.

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_available_phone_numbers_tollfree

Returns a list of toll-free AvailablePhoneNumber elements that match the specified filters, each representing a phone number that is currently available for provisioning within your account. To provision an available phone number, POST the number to the IncomingPhoneNumbers resource.

Parameters

AccountSid (required)

Type: string

IsoCountryCode (required)

ISO 3166-1 alpha-2.

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_call_notifications

Returns a list of notifications generated for an account. The list includes paging information.

Parameters

AccountSid (required)

Type: string

CallSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_call_recordings

Returns a list of Recording resource representations, each representing a recording generated during the course of a phone call.

Parameters

AccountSid (required)

Type: string

CallSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_calls

Returns a list of phone calls made to and from the account identified by {AccountSid}.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_conferences

Returns a list of conferences within an account. The list includes paging information.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_connect_app_resources

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.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_connect_apps

Returns a list of Connect App resource representations, each representing a Connect App in your account. The list includes paging information.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_credential_list_mappings

Get the user lists mapped to this domain.

Parameters

AccountSid (required)

Type: string

SipDomainSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_credential_lists

Gets a list of Credential Lists for an account

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_credentials_in_list

Get the list of Credentials in a CredentialList. The passwords for the Credentials are intentionally not returned so as to protect them.

Parameters

AccountSid (required)

Type: string

CLSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_domains

Returns a paged list of the domains for an account.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_incoming_phone_numbers

Returns a list of IncomingPhoneNumber resource representations, each representing a phone number given to your account. The list includes paging information.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_incoming_phone_numbers_local

Returns a list of local elements, each representing a local (not toll-free) phone number given to your account, under an list element that includes paging information. Works exactly the same as the IncomingPhoneNumber resource, but filters out toll-free numbers.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

Type: string

list_incoming_phone_numbers_mobile

Returns a list of local elements, each representing a mobile phone number given to your account, under an list element that includes paging information. Works exactly the same as the IncomingPhoneNumber resource, but filters out local and toll free numbers.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

Type: string

list_incoming_phone_numbers_tollfree

Returns a list of local elements, each representing a toll-free phone number given to your account, under an list element that includes paging information. Works exactly the same as the IncomingPhoneNumber resource, but filters out all numbers that aren't toll-free.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

Type: string

list_ip_access_control_list_mappings

Return the IpAccessControlListMappings that are associated to this domain.

Parameters

AccountSid (required)

Type: string

SipDomainSid (required)

Type: string

mediaTypeExtension (required)

Type: string

list_ip_access_control_lists

Return a paged list of all IpAccessControlLists under this account.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

Type: string

list_ip_addresses_in_list

List the IP Addresses contained in this list.

Parameters

AccountSid (required)

Type: string

IpAccessControlListSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_media_for_message

Returns a list of media associated with your message.

Parameters

AccountSid (required)

Type: string

MessageSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_members_of_queue

Returns the list of members in the queue identified by {QueueSid}.

Parameters

AccountSid (required)

Type: string

QueueSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_messages

Returns a list of messages associated with your account. The list includes paging information.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_notifications

Returns a list of notifications generated for an account. The list includes paging information.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_outgoing_caller_ids

Returns a list of OutgoingCallerId resource representations, each representing a Caller ID number valid for an account. The list includes paging information.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_participants

Returns the list of participants in the conference identified by {ConferenceSid}.

Parameters

AccountSid (required)

Type: string

ConferenceSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_queues

Returns a list of queues within an account. The list includes paging information.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_recording_transcriptions

Returns a set of Transcription resource representations that includes paging information.

Parameters

AccountSid (required)

Type: string

RecordingSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_recordings

Returns a list of Recording resource representations, each representing a recording generated during the course of a phone call.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_shortcodes

Returns a list of ShortCode resource representations, each representing a short code within your account. The list includes paging information.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_transcriptions

Returns a set of Transcription resource representations that includes paging information.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_usage_records_for_subresource

Returns UsageRecords for all usage categories for a specified subresource.

Parameters

AccountSid (required)

Type: string

Subresource (required)

SubresourceDescription
DailyReturn multiple UsageRecords for each usage category, each representing usage over a daily time-interval.
MonthlyReturn multiple UsageRecords for each usage category, each representing usage over a monthly time-interval.
YearlyReturn multple UsageRecords for each usage category, each representing usage over a yearly time-interval.
AllTimeReturn a single UsageRecord for each usage category, each representing usage over the date-range specified. This is the same as the root /Usage/Records.
TodayReturn a single UsageRecord per usage category, for today's usage only.
Yesterday
ThisMonthReturn a single UsageRecord per usage category, for this month's usage only.
LastMonthReturn a single UsageRecord per usage category, for last month's usage only.

Type: string

Potential values: Daily, Monthly, Yearly, AllTime, Today, Yesterday, ThisMonth, LastMonth

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

list_usage_triggers

Returns a list of UsageTrigger resource representations. The list includes paging information. By default, all UsageTriggers are returned. You can filter the list by specifying one or more query parameters. Note that the query parameters are case-sensitive

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

modify_call

Modify a phone call.

Parameters

AccountSid (required)

Type: string

CallSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

place_call

To make a call, make an HTTP POST request. Initiate a new phone call.

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

$body

Type: object

{
  "To" : "The destination phone number. Format with a '+' and country code e.g., +16175551212 (E.164 format).\n",
  "From" : "A Twilio phone number (in E.164 format) or alphanumeric sender ID enabled for the type of message you wish to send. Phone numbers or short codes purchased from Twilio work here. You cannot (for example) spoof messages from your own cell phone number.\n",
  "Url" : "A URL that hosts a set of TwiML instructions. An example is 'http://demo.twilio.com/docs/voice.xml'"
}

release_incoming_phone_number

Release this phone number from your account. Twilio will no longer answer calls to this number, and you will stop being billed the monthly phone number fee. The phone number will eventually be recycled and potentially given to another customer, so use with care. If you make a mistake, contac us. We may be able to give you the number back.

Parameters

AccountSid (required)

Type: string

IncomingPhoneNumberSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

remove_participant_from_conference

Kick this participant from the conference.

Parameters

AccountSid (required)

Type: string

CallSid (required)

Type: string

ConferenceSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

rename_ip_access_control_list

Rename an IpAccessControlList.

Parameters

AccountSid (required)

Type: string

IpAccessControlListSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

send_message

To send a new outgoing message, make an HTTP POST to your Messages list resource URI

Parameters

AccountSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

$body

Type: object

{
  "MessagingServiceSid" : "The 34 character unique id of the Messaging Service you want to associate with this Message. Set this parameter to use the Messaging Service Settings and Copilot Features you have configured. When only this parameter is set, Twilio will use your enabled Copilot Features to select the From phone number for delivery.\n",
  "MediaUrl" : "The URL of the media you wish to send out with the message. gif , png and jpeg content is currently supported and will be formatted correctly on the recipient's device. Other types are also accepted by the API. The media size limit is 5MB. If you wish to send more than one image in the message body, please provide multiple MediaUrls values in the POST request. You may include up to 10 MediaUrls per message.\n",
  "To" : "The destination phone number. Format with a '+' and country code e.g., +16175551212 (E.164 format).\n",
  "From" : "A Twilio phone number (in E.164 format) or alphanumeric sender ID enabled for the type of message you wish to send. Phone numbers or short codes purchased from Twilio work here. You cannot (for example) spoof messages from your own cell phone number.\n",
  "Body" : "The text of the message you want to send, limited to 1600 characters.\n"
}

update_account

Allows you to modify the properties of an account.

Parameters

AccountSid (required)

A 34 character string that uniquely identifies this account.

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

update_app_properties

Tries to update the application's properties, and returns the updated resource representation if successful. The returned response is identical to that returned above when making a GET request.

Parameters

AccountSid (required)

Type: string

ApplicationSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

update_connect_app_properties

Tries to update the Connect App's properties, and returns the updated resource representation if successful. The returned response is identical to that returned above when making a GET request.

Parameters

AccountSid (required)

Type: string

ConnectAppSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

update_credential_list

Change the FriendlyName of the list

Parameters

AccountSid (required)

Type: string

CLSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

update_domain

Update the attributes of a domain.

Parameters

AccountSid (required)

Type: string

SipDomainSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

update_incoming_phone_number

Tries to update the incoming phone number's properties, and returns the updated resource representation if successful. The returned response is identical to that returned above when making a GET request.

Parameters

AccountSid (required)

Type: string

IncomingPhoneNumberSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

update_ip_address_in_list

Change the description or IP address of a given IpAddress instance resource

Parameters

AccountSid (required)

Type: string

IpAccessControlListSid (required)

Type: string

IpAddressSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

update_outgoing_caller_id

Updates the caller id, and returns the updated resource if successful.

Parameters

AccountSid (required)

Type: string

OutgoingCallerIdSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

update_participant

Updates the status of a participant.

Parameters

AccountSid (required)

Type: string

CallSid (required)

Type: string

ConferenceSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

update_queue

This POST request allows you to change the FriendlyName or MaxSize.

Parameters

AccountSid (required)

Type: string

QueueSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

update_shortcode

Tries to update the shortcode's properties, and returns the updated resource representation if successful.

Parameters

AccountSid (required)

Type: string

ShortCodeSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html

update_usage_trigger

Tries to update the UsageTrigger's properties, and returns the updated resource representation if successful.

Parameters

AccountSid (required)

Type: string

UsageTriggerSid (required)

Type: string

mediaTypeExtension (required)

By default, Twilio's REST API returns XML. You may obtain CSV, JSON or HTML by appending ".csv", ".json", or ".html".

Type: string

Potential values: .json, .csv, .html