Overview
Twilio is a communications platform for programmatic SMS, voice, WhatsApp, verification, and phone-number lookup. The Automize Twilio connector covers the message/call lifecycle, contact verification (OTP), and number metadata.
- Regions: Twilio operates regional APIs (US1, IE1, AU1, SG1, BR1). Account SIDs are global but resources can be scoped to a region. Connector talks to api.twilio.com (auto-routes by account location).
- Plans: Twilio is pay-as-you-go. All accounts have API access. SMS deliverability + cost vary by destination country and number type.
Setting up the connection
Auth type: HTTP Basic.
- Sign in to console.twilio.com → Account → API keys & tokens.
- Copy your Account SID and Auth Token (or create an API Key for granular scoping).
- In Automize, open Settings → Connectors → Twilio → Add connection. Use Account SID as username, Auth Token as password.
Find your credentials at https://console.twilio.com/.
Rate limits
Twilio enforces ~1 message/sec on free trial, ~10/sec on paid. Higher via support ticket. Voice calls have lower per-second limits. The connector retries 429 with exponential backoff. For high-volume SMS, use Messaging Services (pooled numbers) rather than a single From number.
Data model
Phone-centric:
Account (SID) ─┬─ Phone Numbers (your purchased numbers)
├─ Messages (SMS + MMS + WhatsApp)
├─ Calls (voice)
├─ Verifications (OTP service)
└─ RecordingsAvailable operations
17 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Check verification | General | Check a Twilio Verify OTP code. |
| Create Conversation | General | Create a conversation |
| Delete recording | General | Delete a Twilio recording. |
| Get call | General | Get a Twilio call by SID. |
| Get message | General | Get a Twilio message by SID. |
| Get recording | General | Get a Twilio recording by SID. |
| List Available Numbers | General | Search available local numbers by country |
| List calls | General | List Twilio calls. |
| List Conversations | General | List conversations |
| List messages | General | List Twilio messages. |
| List Phone Numbers | General | List owned phone numbers |
| List recordings | General | List Twilio call recordings. |
| Lookup phone number | General | Lookup information about a phone number via Twilio. |
| Make call | General | Make a phone call via Twilio. |
| Send SMS | General | Send an SMS via Twilio. |
| Send verification | General | Send a Twilio Verify OTP code. |
| Update call | General | Update a Twilio call (e.g. end, redirect). |
Operations
Check verification
Check a Twilio Verify OTP code.
| Parameter | Required | Type | Description |
|---|---|---|---|
Service Sid service_sid | Yes | text | |
To To | Yes | text | |
Code Code | Yes | text |
Create Conversation
Create a conversation
| Parameter | Required | Type | Description |
|---|---|---|---|
Friendlyname FriendlyName | No | text |
Tips
- Creates a new conversation thread. Add participants via Add Participant (separate flow).
Delete recording
Delete a Twilio recording.
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Sid account_sid | Yes | text | |
Recording Sid recording_sid | Yes | text |
Get call
Get a Twilio call by SID.
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Sid account_sid | Yes | text | |
Call Sid call_sid | Yes | text |
Tips
- call_sid (CA...). Returns status, duration, prices.
Get message
Get a Twilio message by SID.
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Sid account_sid | Yes | text | |
Message Sid message_sid | Yes | text |
Tips
- message_sid (SM... or MM...). Returns status (queued, sent, delivered, undelivered, failed).
Get recording
Get a Twilio recording by SID.
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Sid account_sid | Yes | text | |
Recording Sid recording_sid | Yes | text |
List Available Numbers
Search available local numbers by country
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Sid account_sid | Yes | text | |
Country Code country_code | Yes | text |
List calls
List Twilio calls.
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Sid account_sid | Yes | text |
Tips
- Same filter contract as messages.
List Conversations
List conversations
No input parameters.
Tips
- Twilio Conversations API – multi-channel threaded messaging. Returns conversations the project participates in.
List messages
List Twilio messages.
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Sid account_sid | Yes | text |
Tips
- Filter by To, From, DateSent (>=, <=). Pages via PageSize + Page.
List Phone Numbers
List owned phone numbers
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Sid account_sid | Yes | text |
Tips
- Your owned Twilio numbers. Returns SMS/voice capabilities per number.
List recordings
List Twilio call recordings.
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Sid account_sid | Yes | text |
Tips
- Returns voice recordings. Filter by CallSid for recordings on a specific call.
Lookup phone number
Lookup information about a phone number via Twilio.
| Parameter | Required | Type | Description |
|---|---|---|---|
Phone Number phone_number | Yes | text |
Tips
- Returns caller_name, line_type (mobile, landline, voip), carrier – useful for fraud / segmentation.
- Each lookup costs $; results are good but not free.
Make call
Make a phone call via Twilio.
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Sid account_sid | Yes | text | |
To To | Yes | text | |
From From | Yes | text | |
Url Url | Yes | text | |
Twiml Twiml | Yes | text |
Tips
- to + from + url (TwiML URL that controls the call flow) OR twiml (inline TwiML).
Send SMS
Send an SMS via Twilio.
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Sid account_sid | Yes | text | |
To To | Yes | text | |
From From | Yes | text | |
Body Body | Yes | textarea | |
Statuscallback StatusCallback | Yes | text |
Tips
- to (E.164 format, e.g. +27821234567) + from + body.
- from must be a Twilio-owned number, an Alphanumeric Sender ID (some countries), or a Messaging Service SID.
- Max 1600 chars; messages over 160 chars segment automatically.
Errors
Invalid 'To' number– Number must be E.164 format with leading +. Reformat at source.The From phone number is not a valid phone number– Either the number doesn't belong to your account or sender ID doesn't match destination country rules.
Send verification
Send a Twilio Verify OTP code.
| Parameter | Required | Type | Description |
|---|---|---|---|
Service Sid service_sid | Yes | text | |
To To | Yes | text | |
Channel Channel | Yes | text |
Update call
Update a Twilio call (e.g. end, redirect).
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Sid account_sid | Yes | text | |
Call Sid call_sid | Yes | text |
FAQ
- Why does my SMS to a country fail?
- Country-specific rules – some need pre-registration (US A2P 10DLC, India DLT), specific number types, or content approval. Check Twilio's country guidelines.
- Status callback – how?
- Pass status_callback URL on Send SMS – Twilio POSTs status changes (sent → delivered/failed) to your webhook. Configure separately in Automize webhooks.
- Trial account limitations?
- Trial accounts can only send to verified phone numbers + have 'Sent from Twilio trial account' prepended to every SMS. Upgrade to a paid account to remove.
- WhatsApp template – when?
- Outside of a 24h business-initiated conversation window, you must use a pre-approved template. Within the 24h window after the user messages you, freeform replies are allowed.