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

> ## Agent Instructions
> Use the public API base URL: https://api.teamfollowup.ai/api.
> Authenticate public API requests with Authorization: Bearer YOUR_API_KEY.
> Use product-owned terms: agents, calls, campaigns, contacts, phone numbers, billing, and configuration.

# Connect your own Twilio numbers

> Use phone numbers you already own in Twilio as caller IDs for your agents. You are never billed here for them.

Bring Your Own Carrier lets you use phone numbers you already own in your Twilio
account as caller IDs for your agents. You are never billed here for those
numbers. Calls run through your Twilio account, on your Twilio bill.

## What you need

* A Twilio account with at least one voice number.
* Your Twilio Account SID.
* A Twilio API key set to the **Standard** key type, and its Secret.

## Step 1. Get your Twilio credentials

<Steps>
  <Step title="Copy your Account SID">
    Sign in to the Twilio Console. Your Account SID is the value that starts with
    `AC`, shown under Account Info on the Console home page. You can also copy it
    from the Console URL when it is visible there. If you use subaccounts, make
    sure it is the same account where you create the API key below.
  </Step>

  <Step title="Create a Standard API key">
    Go to Account, then API keys & tokens, then Create API key. Give it a name
    you will recognise, set the **Key type** to **Standard**, and click Create.
  </Step>

  <Step title="Save the SID and Secret">
    Twilio shows the API Key SID (it starts with `SK`) and the Secret. Copy both
    now. The Secret is shown only once, so save it before you leave the page.
  </Step>
</Steps>

<Note>
  Prefer not to make an API key? You can use your Account SID and Auth token
  instead. An API key is the safer choice, since you can revoke it later without
  rotating your account.
</Note>

## Step 2. Connect Twilio in the app

<Steps>
  <Step title="Open the connect dialog">
    Go to Phone Numbers, then click Connect your Twilio account.
  </Step>

  <Step title="Enter your credentials">
    Paste your Account SID, then the API Key SID and Secret. Leave Use auth token
    off unless you chose the auth token route above.
  </Step>

  <Step title="Connect">
    Click Connect. We check the credentials with Twilio before saving anything.
  </Step>
</Steps>

## Step 3. Import a number

<Steps>
  <Step title="Open the import dialog">
    Click Import a number from Twilio.
  </Step>

  <Step title="Pick a campaign and a number">
    Choose the campaign the number should call from, then pick one of your Twilio
    voice numbers.
  </Step>

  <Step title="Import">
    Click Import. There is no charge and no monthly fee. The number stays in your
    Twilio account and is ready to make and take calls right away.
  </Step>
</Steps>

## Good to know

* We never buy or release your numbers. They stay yours.
* Removing a number here restores its previous Twilio voice settings and leaves
  it in your account.
* Your imported numbers work for both outbound and inbound calls.

<Note>
  New to caller IDs? See [The phone number people see](/campaigns/phone-numbers)
  for why the number you call from matters.
</Note>