> ## Documentation Index
> Fetch the complete documentation index at: https://developer.watson-orchestrate.ibm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Twilio SMS

Enable SMS messaging for your agent using Twilio.

### Prerequisites

* A Twilio account
* A Twilio Account SID
* A Twilio Authentication Token
* A Twilio phone number

### Create a Twilio SMS channel

**Using CLI:**

```bash BASH theme={null}
orchestrate channels create \
  --agent-name my_agent \
  --env live \
  --type twilio_sms \
  --name "SMS Support" \
  --field account_sid=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
  --field twilio_authentication_token=your_auth_token_here \
  --field phone_number=+1234567890
```

**Using YAML:**

```yaml YAML theme={null}
name: "SMS Support"
description: "Customer support via SMS"
channel: "twilio_sms"
spec_version: "v1"
kind: "channel"
account_sid: "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
twilio_authentication_token: "your_auth_token_here"
phone_number: "+1234567890"
```

**Using Python:**

```python Python theme={null}
from ibm_watsonx_orchestrate.agent_builder.channels import TwilioSMSChannel

sms = TwilioSMSChannel(
    name="SMS Support",
    description="Customer support via SMS",
    account_sid="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    twilio_authentication_token="your_auth_token_here",
    phone_number="+1234567890"
)
```

### Configuration requirements

| Field                         | Required | Format | Description                      |
| ----------------------------- | -------- | ------ | -------------------------------- |
| `account_sid`                 | Yes      | String | Your Twilio Account SID          |
| `twilio_authentication_token` | Yes      | String | Your Twilio Authentication Token |
| `phone_number`                | No       | String | Twilio phone number for SMS      |