We aim to provide accurate and helpful details about third‑party tools, but we can’t guarantee that this information is always complete or up to date. If you notice any discrepancies, feel free to share them in the feedback section below. For the most reliable information, please always refer to the third‑party tool’s official documentation.
Twilio is a cloud communications platform for sending SMS text messages and other programmable messaging.
This component allows sending SMS messages, retrieving message records, and reacting to Twilio events from within an integration.
API Documentation
This component was built using the Twilio Programmable Messaging API (API version 2010-04-01).
Connections
API Key
Authenticate requests to Twilio using an API key and secret.
This component authenticates with Twilio using an API key and secret pair generated from the Twilio console.
Prerequisites
- A Twilio account with access to the Twilio Console
- Permissions to create API keys for the account
Setup Steps
- Sign in to the Twilio Console
- In the top-right of the screen, click Account -> API Keys & Tokens
- Select Create API Key
- Enter a descriptive name for the key and select Standard for Key type
- Take note of the API key's SID and Secret (the secret is only shown once)
- From the Twilio console, locate the Account SID (it starts with
AC)
Configure the Connection
Create a connection of type API Key and enter the following values:
- Account SID: The Twilio Account SID, which starts with
AC(for example,ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX) - API Key SID: The API Key SID created in the previous step, which starts with
SK(for example,SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX) - API Key Secret: The secret generated when the API key was created
The API key secret is only displayed once at creation time. Save it in a secure location before leaving the page.
| Input | Comments | Default |
|---|---|---|
| Account SID | The Twilio Account SID (starts with AC). | |
| API Key SID | The API Key SID (starts with SK). | |
| API Key Secret | The API secret generated when the API key was created. |
Basic Authentication
Authenticate requests to Twilio using an Account SID and Auth Token.
When a Twilio account is created, an Account String Identifier (Account SID) and Auth Token are generated automatically.
The Account SID and Auth Token can be used to authenticate with Twilio and send SMS messages.
Prerequisites
- A Twilio account with access to the Twilio Console
Setup Steps
- Sign in to the Twilio Console
- From the Account Info panel on the dashboard, locate the Account SID (starts with
AC) and the Auth Token - Copy both values for use in the connection configuration
Configure the Connection
Create a connection of type Basic Authentication and enter the following values:
- Account SID: The Twilio Account SID, which starts with
AC - Auth Token: The Auth Token shown in the Twilio Console
For security reasons, the API Key Connection is recommended over Basic Authentication.
API keys can be revoked independently, and auth tokens generated using API keys are short-lived.
| Input | Comments | Default |
|---|---|---|
| Account SID | The Twilio Account SID (starts with AC). | |
| Auth Token | The Auth Token from the Twilio Console. |
Triggers
New and Updated Records
Checks for newly sent Twilio messages on a configured schedule. Returned messages appear in the created bucket; the updated bucket is preserved for shape parity but is always empty because Twilio polling does not detect status changes to already-sent messages.
| Input | Comments | Default |
|---|---|---|
| Connection | The Twilio connection to use. | |
| From Filter | The sender phone number to filter polled messages by, in E.164 format. Leave blank to include all senders. | |
| To Filter | The recipient phone number to filter polled messages by, in E.164 format. Leave blank to include all recipients. | |
| Show New Records | When true, newly sent messages are included in the trigger output. | true |
| Show Updated Records | Reserved for shape consistency with other polling triggers. Twilio polling does not detect status changes to already-sent messages (use the webhook trigger for status callbacks). The 'updated' bucket is always empty. | true |
Webhook
Receive and validate webhook requests from Twilio for manually configured webhook subscriptions.
Actions
Get SMS
Retrieve an SMS message by SID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Twilio connection to use. | |
| Message SID | The unique identifier for the SMS message. |
List SMS Messages
List SMS messages from the Twilio account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Twilio connection to use. |
Raw Request
Send a raw HTTP request to Twilio.
| Input | Comments | Default |
|---|---|---|
| Connection | The Twilio connection to use. | |
| URL | Input the path only (/Accounts/$TWILIO_ACCOUNT_SID/Messages.json), The base URL is already included (https://api.twilio.com/2010-04-01). For example, to connect to https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Messages.json, only /Accounts/$TWILIO_ACCOUNT_SID/Messages.json is entered in this field. | |
| Method | The HTTP method to use. | |
| Data | The HTTP body payload to send to the URL. | |
| Form Data | The Form Data to be sent as a multipart form upload. | |
| File Data | File Data to be sent as a multipart form upload. | |
| File Data File Names | File names to apply to the file data inputs. Keys must match the file data keys above. | |
| Query Parameter | A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2. | |
| Header | A list of headers to send with the request. | |
| Response Type | The type of data you expect in the response. You can request json, text, or binary data. | json |
| Timeout | The maximum time that a client will await a response to its request | |
| Retry Delay (ms) | The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. | 0 |
| Retry On All Errors | If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. | false |
| Max Retry Count | The maximum number of retries to attempt. Specify 0 for no retries. | 0 |
| Use Exponential Backoff | Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. | false |
Send SMS
Send an SMS message via Twilio.
| Input | Comments | Default |
|---|---|---|
| Connection | The Twilio connection to use. | |
| To | The SMS recipient's phone number in E.164 format. | |
| From | The SMS sender's phone number in E.164 format. | |
| Message | The text content of the SMS message to send. |