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 |
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.
The connector supports the following authentication types:
Default | Parameters for creating connection. | All regions | Shareable |
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 |
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 1200 | 60 seconds |
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. |
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
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
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
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
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. |
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. |
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. |