Twilio integration

Communications: SMS, voice calls, WhatsApp, verify, lookups

Help CentreConnectors

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.

  1. Sign in to console.twilio.com → Account → API keys & tokens.
  2. Copy your Account SID and Auth Token (or create an API Key for granular scoping).
  3. 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)
                   └─ Recordings

Available operations

17 operations available. Click any row to jump to its detail.

OperationCategoryWhat it does
Check verificationGeneralCheck a Twilio Verify OTP code.
Create ConversationGeneralCreate a conversation
Delete recordingGeneralDelete a Twilio recording.
Get callGeneralGet a Twilio call by SID.
Get messageGeneralGet a Twilio message by SID.
Get recordingGeneralGet a Twilio recording by SID.
List Available NumbersGeneralSearch available local numbers by country
List callsGeneralList Twilio calls.
List ConversationsGeneralList conversations
List messagesGeneralList Twilio messages.
List Phone NumbersGeneralList owned phone numbers
List recordingsGeneralList Twilio call recordings.
Lookup phone numberGeneralLookup information about a phone number via Twilio.
Make callGeneralMake a phone call via Twilio.
Send SMSGeneralSend an SMS via Twilio.
Send verificationGeneralSend a Twilio Verify OTP code.
Update callGeneralUpdate a Twilio call (e.g. end, redirect).

Operations

Check verification

Check a Twilio Verify OTP code.

ParameterRequiredTypeDescription
Service Sid service_sidYestext
To ToYestext
Code CodeYestext

Create Conversation

Create a conversation

ParameterRequiredTypeDescription
Friendlyname FriendlyNameNotext

Tips

  • Creates a new conversation thread. Add participants via Add Participant (separate flow).

Delete recording

Delete a Twilio recording.

ParameterRequiredTypeDescription
Account Sid account_sidYestext
Recording Sid recording_sidYestext

Get call

Get a Twilio call by SID.

ParameterRequiredTypeDescription
Account Sid account_sidYestext
Call Sid call_sidYestext

Tips

  • call_sid (CA...). Returns status, duration, prices.

Get message

Get a Twilio message by SID.

ParameterRequiredTypeDescription
Account Sid account_sidYestext
Message Sid message_sidYestext

Tips

  • message_sid (SM... or MM...). Returns status (queued, sent, delivered, undelivered, failed).

Get recording

Get a Twilio recording by SID.

ParameterRequiredTypeDescription
Account Sid account_sidYestext
Recording Sid recording_sidYestext

List Available Numbers

Search available local numbers by country

ParameterRequiredTypeDescription
Account Sid account_sidYestext
Country Code country_codeYestext

List calls

List Twilio calls.

ParameterRequiredTypeDescription
Account Sid account_sidYestext

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.

ParameterRequiredTypeDescription
Account Sid account_sidYestext

Tips

  • Filter by To, From, DateSent (>=, <=). Pages via PageSize + Page.

List Phone Numbers

List owned phone numbers

ParameterRequiredTypeDescription
Account Sid account_sidYestext

Tips

  • Your owned Twilio numbers. Returns SMS/voice capabilities per number.

List recordings

List Twilio call recordings.

ParameterRequiredTypeDescription
Account Sid account_sidYestext

Tips

  • Returns voice recordings. Filter by CallSid for recordings on a specific call.

Lookup phone number

Lookup information about a phone number via Twilio.

ParameterRequiredTypeDescription
Phone Number phone_numberYestext

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.

ParameterRequiredTypeDescription
Account Sid account_sidYestext
To ToYestext
From FromYestext
Url UrlYestext
Twiml TwimlYestext

Tips

  • to + from + url (TwiML URL that controls the call flow) OR twiml (inline TwiML).

Send SMS

Send an SMS via Twilio.

ParameterRequiredTypeDescription
Account Sid account_sidYestext
To ToYestext
From FromYestext
Body BodyYestextarea
Statuscallback StatusCallbackYestext

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.

ParameterRequiredTypeDescription
Service Sid service_sidYestext
To ToYestext
Channel ChannelYestext

Update call

Update a Twilio call (e.g. end, redirect).

ParameterRequiredTypeDescription
Account Sid account_sidYestext
Call Sid call_sidYestext

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.

Related connectors

See it working on your own data

Everything documented here ships with the platform – try the document tools free, or go live in 7 days.