> ## Documentation Index
> Fetch the complete documentation index at: https://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

<Steps>
  <Step title="Open the Twilio Console">
    Sign in to the [Twilio Console](https://console.twilio.com).
  </Step>

  <Step title="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).
  </Step>

  <Step title="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.
  </Step>
</Steps>

<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.
</Note>

## Connect to Adapt

<Steps>
  <Step title="Open Integrations">
    In Adapt, go to **Settings > Integrations**.
  </Step>

  <Step title="Find Twilio">
    Search for **Twilio** and select it from the catalog.
  </Step>

  <Step title="Start the connection">
    Click **Connect** to open the connection form.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Test the connection">
    Ask Adapt to list your recent messages.
  </Step>
</Steps>

### 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.
```