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

# Twilio

> Connect Twilio to Adapt to send SMS and review messaging logs

Twilio is a communications platform for SMS, voice, and more. Connect it to
Adapt with your Account SID and Auth Token.

## Set up credentials

**1. Open the Twilio Console**

Sign in to the [Twilio Console](https://console.twilio.com).

**2. Copy your Account SID and Auth Token**

On the Console dashboard, find the **Account Info** panel. Copy the
**Account SID** (it starts with `AC`) and the **Auth Token** (click **Show**
to reveal it, then copy).

**3. Find an active phone number (optional)**

Go to **Phone Numbers > Manage > Active Numbers** and copy a number you own,
in E.164 format (for example, `+14155551234`). Use this if you want to send
SMS from a specific number.

> [!NOTE]
>
> The Auth Token is sensitive and grants full access to your account. Keep it
> private and rotate it from the Console if it is ever exposed.

## Connect to Adapt

**1. Open Integrations**

In Adapt, go to **Settings > Integrations**.

**2. Find Twilio**

Search for **Twilio** and select it from the catalog.

**3. Start the connection**

Click **Connect** to open the connection form.

**4. Add your credentials**

Enter the values you gathered above, then click **Add connection**:

| Secret Name | Value |
| - | - |
| `TWILIO_ACCOUNT_SID` | Your Account SID |
| `TWILIO_AUTH_TOKEN` | Your Auth Token |
| `TWILIO_PHONE_NUMBER` | Your Twilio phone number (optional) |

You can rename the connection and choose whether it is shared with your
organization or kept personal to you.

**5. Test the connection**

Ask Adapt to list your recent messages.

### Security

* Credentials are encrypted at rest with AES-256
* The Auth Token acts as your account password; rotate it from the Console if exposed
* Consider using a subaccount to limit the scope of access
* Never share your Account SID or Auth Token or commit them to source control

## Capabilities

Send SMS messages through Twilio, and review messaging logs and delivery status
from Adapt.

### Examples

Send an SMS:

```
Send a Twilio SMS to +14155550123 reminding them about tomorrow's appointment.
```

Review messaging logs:

```
Show my Twilio messages sent in the last 24 hours and their delivery status.
```

Investigate failures:

```
List Twilio messages that failed today and summarize the error codes.
```

Check a number:

```
Tell me which of my active Twilio numbers can send SMS.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.