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

# Twilio

> Connect your PolyAI agent to Twilio for voice automation and handoffs.

<Note>
  For basic Twilio number and SMS setup, see [Voice > Numbers > Twilio](/voice-channel/numbers/twilio/introduction).
</Note>

Connect Twilio to your PolyAI project from Agent Studio. PolyAI uses your Twilio API credentials to automatically provision the SIP trunk(s) needed to route calls to your agent — you just bring your API keys and your own phone numbers.

## Quick setup

<Steps>
  <Step title="Open Integrations">
    In Agent Studio, go to **Integrations** and click **Connect** on the Twilio card.

    <Frame>
      <img src="https://mintcdn.com/polyai/hXB2vrkcQXEtpr_h/images/integrations/twilio/integrations-page.png?fit=max&auto=format&n=hXB2vrkcQXEtpr_h&q=85&s=b076f74f28d51506606f7fb7ae1a2030" alt="The Integrations page in Agent Studio showing available telephony providers including Twilio." width="3016" height="1358" data-path="images/integrations/twilio/integrations-page.png" />
    </Frame>
  </Step>

  <Step title="Enter your Twilio account credentials">
    In the **Step 1: Twilio account credentials** panel, paste:

    * **API Key**
    * **API Secret**
    * **Account SID**

    <Frame>
      <img src="https://mintcdn.com/polyai/hXB2vrkcQXEtpr_h/images/integrations/twilio/twilio-credentials-modal.png?fit=max&auto=format&n=hXB2vrkcQXEtpr_h&q=85&s=95b70206a375765c67fc7d3588ffd966" alt="The Twilio account credentials panel showing fields for API Key, API Secret, and Account SID." width="2506" height="1638" data-path="images/integrations/twilio/twilio-credentials-modal.png" />
    </Frame>

    PolyAI uses these to provision the SIP trunk(s) on your Twilio account. Click **Continue**.
  </Step>

  <Step title="Add your phone numbers">
    Add the Twilio numbers you want to route to PolyAI for **Sandbox**, **Pre-release**, and **Live**. Numbers must be in E.164 format with a country code (e.g. `+441234567890`).
  </Step>

  <Step title="Submit">
    PolyAI provisions the SIP trunk on your Twilio account and wires up routing per environment. You're then taken to **Voice > Handoffs** to configure transfers back to a human agent.
  </Step>
</Steps>

That's it — no manual TwiML, no PolyAI ticket, no shared SIP trunk to negotiate.

## Where to find your Twilio credentials

In the [Twilio Console](https://console.twilio.com/):

* **Account SID** — top of the **Account Info** panel on the dashboard.
* **API Key + API Secret** — **Account > API keys & tokens > Create API key**. The secret is shown once at creation; copy it before closing the dialog.

Use a Standard API key with permissions to manage SIP trunks on the account.

## Editing or removing the integration

* **Update routing** — re-open the Twilio card in **Integrations** to add or remove numbers per environment.
* **Disconnect** — use the **Disconnect** action on the integration. PolyAI removes the routing on its side and tears down the SIP trunk it provisioned.

## Configuring handoffs

After the integration is connected, configure how calls transfer back to human agents in **Voice > Handoffs**. See [Call handoffs](/voice-channel/handoffs) for the full reference.

## Related pages

* [Voice > Numbers > Twilio](/voice-channel/numbers/twilio/introduction) — basic Twilio number and SMS setup
* [Call handoffs](/voice-channel/handoffs) — configure transfer destinations
* [Voice integrations](/integrations/voice/introduction) — other voice platforms