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

# Twilio

> Set up and use the Twilio integration with Hyper AI

Auth type: API

<Info>
  For general setup steps, permissions, and troubleshooting, start with: [App Integrations](/integrations/overview).
</Info>

## Connect Twilio

1. Go to Settings → Apps in Hyper
2. Select Twilio → Connect New
3. Provide your Twilio Account SID and Auth Token

## Common capabilities

* Send and receive SMS messages
* Automate voice and messaging workflows
* Trigger notifications via programmable APIs

## Use in Chat

Enable Twilio in the tool selector. Ask your agent to send SMS messages or manage communication workflows.

## Use in Agents

Add Twilio to an agent's toolkits and select the connection. Mark sensitive actions (send SMS) as "requires approval."

## Use in Flows

Automate SMS notifications, voice calls, and messaging sequences using Twilio action nodes.

## Troubleshooting

* Messages not sending: verify Account SID, Auth Token, and sender phone number
* Rate limits: check Twilio account messaging limits

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action                      | Description                                                     |
| --------------------------- | --------------------------------------------------------------- |
| Buy Phone Number            | Purchase a phone number for your account                        |
| Check Delivery Status       | Check the delivery status of a sent message                     |
| Check Verification          | Check if a verification code is valid                           |
| Create Subaccount           | Create a subaccount                                             |
| Create Verification Service | Create a new Twilio Verify service for phone/email verification |
| Delete Recording            | Delete a recording                                              |
| Get Account                 | Get your Twilio account details                                 |
| Get Call                    | Get details of a specific voice call                            |
| Get Message                 | Get details of a specific SMS message by its SID                |
| Get Recording               | Get details of a specific recording                             |
| List Calls                  | List voice calls with optional filters                          |
| List Messages               | List SMS messages with optional filters                         |
| List Phone Numbers          | List phone numbers in your Twilio account                       |
| List Recordings             | List call recordings                                            |
| List Subaccounts            | List subaccounts                                                |
| List Usage Records          | List usage records for billing                                  |
| Lookup Phone                | Look up information about a phone number                        |
| Make Call                   | Initiate an outbound voice call                                 |
| Release Phone Number        | Release (delete) a phone number from your account               |
| Search Available Numbers    | Search for available phone numbers to purchase                  |
| Send Sms                    | Send an SMS or MMS message via Twilio                           |
| Send Verification           | Send a verification code to a phone number or email             |
| Send Whatsapp               | Send a WhatsApp message via Twilio                              |
| Update Call                 | Update or modify an in-progress call                            |
| Update Phone Number         | Update a phone number's configuration                           |