Twilio
Twilio enables apps to send and receive global SMS, MMS and IP messages.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Standard | All Power Automate regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Standard | All Power Apps regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Microsoft |
| URL | Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support |
| Connector Metadata | |
|---|---|
| Publisher | Microsoft |
| Website | https://www.twilio.com/ |
| Privacy policy | https://www.twilio.com/legal/privacy |
Requirements
The Twilio connector requires the following information:
Your Twilio account ID and authentication token, which you can find on your Twilio dashboard, to authorize creating a connection from your app. If you're using a Twilio trial account, you can send text messages only to verified phone numbers.
One verified Twilio phone number that can send text messages and another phone number that can receive text messages.
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is shareable connection. If the power app is shared with another user, connection is shared as well. For more information, please see the Connectors overview for canvas apps - Power Apps | Microsoft Docs
| Name | Type | Description | Required |
|---|---|---|---|
| Twilio Account Id | securestring | Twilio Account Id | True |
| Twilio Access Token | securestring | Twilio Access Token | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 1200 | 60 seconds |
Actions
| Get Message |
This operation returns a single message specified by the provided Message ID. |
| List Messages [DEPRECATED] |
Returns a list of messages associated with your account. |
| List Messages V2 |
Returns a list of messages associated with your account. This action supports pagination. |
| Send Text Message (SMS) |
This operation is used to send a new message to a mobile number. |
Get Message
This operation returns a single message specified by the provided Message ID.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Message SID
|
MessageId | True | string |
Unique SID of the message. |
Returns
Proprties of a single message.
- Message
- Message
List Messages [DEPRECATED]
Returns a list of messages associated with your account.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
To Phone Number
|
To | string |
Only show messages to this phone number. |
|
|
From Phone Number
|
From | string |
Only show messages from this phone number. |
|
|
Date Sent
|
DateSent | date |
Only show messages sent on this date (in GMT format), given as YYYY-MM-DD. Example: 2009-07-06. |
|
|
Limit
|
PageSize | integer |
How many resources to return in each list page. Default is 50. |
|
|
Page
|
Page | integer |
Page number. Default is 0. |
Returns
List of one or more messages.
- Message List
- MessageList
List Messages V2
Returns a list of messages associated with your account. This action supports pagination.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
To Phone Number
|
To | string |
Only show messages to this phone number. |
|
|
From Phone Number
|
From | string |
Only show messages from this phone number. |
|
|
Date Sent
|
DateSent | date |
Only show messages sent on this date (in GMT format), given as YYYY-MM-DD. Example: 2009-07-06. |
|
|
Limit
|
PageSize | integer |
How many resources to return in each list page. Default is 50. |
Returns
List of one or more messages.
- Message List V2
- MessageListV2
Send Text Message (SMS)
This operation is used to send a new message to a mobile number.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
From Phone Number
|
from | True | string |
A Twilio phone number (in E.164 format) or alphanumeric sender ID enabled for the type of message you wish to send. |
|
To Phone Number
|
to | True | string |
The destination phone number. Format with a '+' and country code e.g., +16175551212 (E.164 format). |
|
Text
|
body | True | string |
The text of the message you want to send, limited to 1600 characters. |
|
Media Urls
|
media_url | array of uri |
List of URIs of media to be sent. |
|
|
Status Call back
|
StatusCallback | uri |
A URL that Twilio will POST to each time your message status changes. |
|
|
Messaging Service Sid
|
messaging_service_sid | string |
Unique id of the Messaging Service. |
|
|
Application SID
|
application_sid | string |
SID of Twilio Application which is configured with the required Message status call back. |
|
|
Max Price
|
max_price | string |
The total maximum price limit for the message. |
|
|
Validity Period
|
validity_period | string |
The number of seconds that the message can remain in a Twilio queue. |
Returns
Proprties of a single message.
- Message
- Message
Definitions
Message
Proprties of a single message.
| Name | Path | Type | Description |
|---|---|---|---|
|
Text
|
body | string |
Body of the message. |
|
From Number
|
from | phone |
Phone number from which the message was sent. |
|
To Number
|
to | phone |
Phone number to which the message was sent. |
|
Status
|
status | string |
Sent status of the message. |
|
SID
|
sid | string |
SID of the sent message. |
|
Account Sid
|
account_sid | string |
SID of the account associated with the sent message. |
|
API
|
api_version | string |
Version of the API used to send the message. |
|
Segment Count
|
num_segments | string |
Number of segments the message was divided into. |
|
Media Count
|
num_media | string |
Number of media files associated with the sent message. |
|
Created Date-Time
|
date_created | string |
yyyy-MM-ddTHH:mm:ss.fffZ (UTC format) |
|
Sent Date-Time
|
date_sent | string |
yyyy-MM-ddTHH:mm:ss.fffZ (UTC format) |
|
Updated Date-Time
|
date_updated | string |
yyyy-MM-ddTHH:mm:ss.fffZ (UTC format) |
|
Direction
|
direction | string |
Direction associated with the sent message. |
|
Error Codes
|
error_code | integer |
Error codes associated with the sent message, if any. |
|
Error Messages
|
error_message | string |
Error messages associated with the sent message, if any. |
|
Price
|
price | string |
Cost of the sent message. |
|
Unit
|
price_unit | string |
Price unit used to evaluate the cost of the message. |
|
URI
|
uri | uri |
Relative URI for this resource. |
|
Subresource URIs
|
subresource_uris | object |
Relative URIs for any subresources. |
|
Messaging Service Sid
|
messaging_service_sid | string |
Unique id of the messaging Service. |
MessageList
List of one or more messages.
| Name | Path | Type | Description |
|---|---|---|---|
|
messages
|
messages | array of Message | |
|
Page
|
page | integer |
Page number of the respone. |
|
Limit
|
page_size | integer |
Page size of the response. |
|
Page Count
|
num_pages | integer |
Total number of pages in the response. |
|
Start
|
start | integer |
Index of the first message. |
|
End
|
end | integer |
Index of the last message. |
|
URI
|
uri | uri |
Relative URI for this list. |
|
First Page URI
|
first_page_uri | uri |
Relative URI for the first page. |
|
Next Page URI
|
next_page_uri | uri |
Relative URI for the next page. |
|
Message Count
|
total | integer |
Total number of messages. |
|
Previous Page URI
|
previous_page_uri | uri |
Relative URI for the previous page. |
MessageListV2
List of one or more messages.
| Name | Path | Type | Description |
|---|---|---|---|
|
@odata.nextLink
|
@odata.nextLink | string |
Relative URI for the next page. |
|
value
|
value | array of Message |
List of one or more messages. |