> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.rydhm.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.rydhm.ai/_mcp/server.

# Bring your own Twilio

If you already have US numbers in Twilio, you can connect your Twilio account and import them into Rydhm. Your experts answer them and can call out from them. You keep paying Twilio directly for the numbers and their call minutes.

Only admins and the owner can connect Twilio and import numbers. See [Members and roles](/workspace/members).

## Before you start

* **A paid (upgraded) Twilio account.** Twilio trial accounts can't use SIP trunking, which Rydhm needs.
* **US numbers that can take voice calls.** SMS-only and non-US numbers can't be imported.
* **Your Account SID**, plus either your **Auth Token** or a **Standard API key**. Both are on the [Twilio Console](https://console.twilio.com/) home page, in the **Account Info** panel. Press **Show** to see the Auth Token.

To create an API key instead, go to **Account** (top right) → **API keys & tokens** → **Create API key**, with the key type **Standard**. Copy the SID and the secret. Twilio shows the secret only once.

## Connect your account

#### Open the connect dialog

Go to **Settings → Integrations** and find **Phone**. Select **Connect**. You can also start from **Settings → Phone numbers → Add a number → Import from Twilio**.

#### Enter your Account SID

Paste it into **Account SID**. It starts with `AC`.

#### Choose how Rydhm signs in

Under **Sign in with**, choose one:

* **Auth Token**: Rydhm uses it **once** to create its own API key in your account, named "Rydhm (your workspace)", and signs in with that from then on. The Auth Token is never stored.
* **API key**: paste the **API key SID** (starts with `SK`) and the **API key secret**. The secret is stored encrypted.

#### Connect

Select **Connect Twilio**. Checking your account and setting up takes a few seconds, so keep the dialog open. You'll see **Twilio connected**.

## What Rydhm does in your Twilio account

Connecting makes only these changes:

1. **With an Auth Token**, it creates an API key named "Rydhm (your workspace)".
2. It creates an **Elastic SIP trunk** named "Rydhm" that sends calls to Rydhm, with a login so your experts can call out through your account.
3. It **leaves your numbers alone**. A number moves to Rydhm only when you import it.

## Import a number

#### Open the list

Go to **Settings → Phone numbers**, select **Add a number**, then **Import from Twilio**.

#### Pick a number

Each number shows where its calls go today:

* **Not in use**: nothing is set up on it.
* **Used by** a web address, or **Used by a TwiML app**: another product answers it today.
* **On another SIP trunk**: another trunk answers it today.
* **In Rydhm**: it's already imported.

#### Choose who answers

Under **Who answers**, pick an expert, or **Decide later**. Calls aren't answered until you pick one.

#### Import

Select **Import** (the button shows the number). It shows as **Active** within a few seconds.

> **Warning**
>
> Importing a number that another product uses (a voice URL, a TwiML app or another SIP trunk) **moves its calls to Rydhm** straight away. Rydhm remembers the old setup and puts it back if you remove the number from Rydhm later.

A workspace can import up to 50 numbers. A number can be in only one Rydhm workspace at a time.

## Remove a number

On **Settings → Phone numbers**, select **Remove from Rydhm** on the number. Rydhm puts it back as it was in your Twilio account, for example on its old voice URL or trunk. You see **Removed from Rydhm**. **Rydhm never releases an imported number.** It stays yours in Twilio.

If part of the old setup couldn't be restored, the message says what to fix by hand in Twilio.

## Check or disconnect

The **Phone** section on **Settings → Integrations** shows the connected account, the SIP trunk, and how Rydhm signs in.

* **Verify** checks that Rydhm can still sign in and that its trunk is set up as it should be.
* If Twilio starts refusing Rydhm, for example because the API key was deleted, the section shows an error. Select **Connect again**.
* **Disconnect** removes every imported number from Rydhm (each one goes back as it was), deletes the SIP trunk and the login Rydhm made, and forgets its key. Your numbers stay yours in Twilio.

An API key can't delete itself. When you disconnect, you can paste your **Auth Token** so Rydhm can also delete the API key it created. The token is used once and never stored. If you skip it, or anything else can't be cleaned up, Rydhm lists what's left and where to remove it in Twilio.

## Costs

* **Twilio** bills you directly for imported numbers and their call minutes.
* **Rydhm** charges phone call minutes at the usual rate. See [Billing](/workspace/billing).
* Imported numbers don't count toward your plan's included phone numbers and carry no Rydhm number fee: you already pay Twilio for them. Once billing is active, the Free plan can't add numbers, imported or bought.

## Gotchas

* **Outbound calls are US-only**, whichever account the number comes from. See [Phone](/channels/phone#us-only-dialling).
* **Don't edit or delete the "Rydhm" trunk or API key in Twilio.** If calls stop, use **Verify**, then **Connect again**.

## Related

* [Phone](/channels/phone)
* [Campaigns](/channels/campaigns)
* [Security](/workspace/security)