---
updatedAt: 2026-02-26T15:12:30.000Z
agentTools:
  projectIndex: https://developer.intellistack.com/llms.txt
---

# Twilio Step

Send SMS messages as part of your workflow using Twilio. Use this step to deliver text notifications to users from your Twilio account.

The Twilio step sends an SMS message to a phone number using a named connection. Use it to notify users when a workflow session is complete, send verification codes, or deliver time-sensitive alerts via text message.

## Configuration

| name         | type   | required | description                                                                                                                   |
| ------------ | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `connection` | string | yes      | The name of the Twilio connection to use, as configured in Integrations.                                                      |
| `action`     | string | yes      | The operation to perform. Must be `SEND_SMS`.                                                                                 |
| `sendFrom`   | string | yes      | The sender phone number in E.164 format (e.g. `+15557654321`). Must be a Twilio number on your account.                       |
| `sendTo`     | string | yes      | The recipient phone number in E.164 format. Supports [mapping placeholders](https://developer.intellistack.com/docs/mapping). |
| `message`    | string | yes      | The SMS body content. Supports mapping placeholders.                                                                          |

## Example

The example below sends an SMS notification from a Twilio number to a recipient's phone.

```json Send an SMS message
{
  "connection": "twilio-prod",
  "action": "SEND_SMS",
  "sendFrom": "+15557654321",
  "sendTo": "+15551234567",
  "message": "Your verification code is 123456."
}
```