What it connects
The Twilio tool lets your agent send text messages during a conversation. Use it to send confirmation codes, appointment reminders, order updates, or follow-up information to your users.
Run independently through code
You can also run this integration’s actions through code without an agent conversation. Independent execution uses the project’s Draft connection and can perform real actions in the connected service. See Run tools without a conversation (Developers) for schema discovery, inputs, permissions, and results.
Before you connect
A Twilio account, its Account SID, API Key SID and API Key Secret, and a sender phone number that can send SMS from that account.
Set up and test
The steps below use a workflow so you can provide explicit inputs and check the result of one action.
Add the integration
Open a workflow and add an Integration step. Connect it to the preceding step, open its configuration, and choose Twilio.
Connect your account
Enter the Twilio account and API key credentials in the connection dialog. If the account is already connected, check that it is the account you intend to test.
Choose an action
Select Send SMS for this first test. The tool shows the inputs for that action. You can find the other available actions in the reference below.
Configure the inputs
Set from to your Twilio sender number and to to a test recipient you control, including country codes. Enter a short reminder in body.
Use fixed test values first. When the test works, you can map the inputs to variables collected earlier in the conversation.
Run a test and check the result
Use Run to test the workflow and follow the conversation path that reaches the Integration step.
Check the test phone and the Twilio message log. Inspect the status in processedMessages; acceptance of the request does not guarantee delivery.
To let the agent choose when to call the tool, add it to a playbook instead and describe when to use it and what information to collect. Manage existing connections in Settings → Integrations.
Supported actions
The table names the connector’s inputs; optional inputs are marked where listed. Select an action to see its complete configuration.
Use Capture response in an Integration step to save the result, or an object path within it, to a variable. Base the path on the actual returned result.
Send an appointment reminder
These are example input values, not a live execution.
Replace the phone placeholders with a test recipient you control and your Twilio sender number, including country codes. Run Send SMS and inspect the returned message status and Twilio message log. Acceptance of the request is not a delivery guarantee.
Limitations & troubleshooting
This action sends a message; configuring inbound or outbound SMS conversations is a separate channel setup.
The sender is invalid
The sender is invalid
For invalid sender errors, check that from is a valid sender on the connected Twilio account.
The recipient is invalid
The recipient is invalid
For recipient errors, check to.
Related guides
Integration walkthrough · Integration step · All integrations