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.

1

Add the integration

Open a workflow and add an Integration step. Connect it to the preceding step, open its configuration, and choose Twilio.

2

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.

3

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.

4

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.

5

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

For invalid sender errors, check that from is a valid sender on the connected Twilio account.

The recipient is invalid

For recipient errors, check to.

Integration walkthrough · Integration step · All integrations

Inbound SMS · Outbound SMS

Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.