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

# Import Telnyx Phone Numbers into VoiceInfra in One Click

> Connect your Telnyx account to VoiceInfra using your API v2 key and import existing phone numbers in one click. No porting, no billing changes.

The VoiceInfra Telnyx integration connects your existing Telnyx phone numbers to AI agents in minutes. Telnyx keeps handling the telephony and billing exactly as it does today — VoiceInfra adds the intelligence layer on top of every call. Your customers dial the same numbers, and your AI agents answer.

<Note>
  Your numbers remain in your Telnyx account throughout. Telnyx continues to handle telephony and billing. VoiceInfra does not move, port, or take ownership of your numbers.
</Note>

## Prerequisites

Before connecting, retrieve your **API v2 key** from the [Telnyx Portal](https://portal.telnyx.com):

* Navigate to **Auth → API Keys** in your Telnyx Portal
* Create or copy an existing **API v2 key** — it starts with `KEY` and is 64 or more characters long

```text theme={null}
Telnyx API v2 key: KEY0123456789abcdef...  (starts with KEY, 64+ chars)
```

Keep your API key private. VoiceInfra encrypts it at rest and uses it only to fetch your number list via the Telnyx v2 API.

## Import Your Telnyx Numbers

<Steps>
  <Step title="Open the Telnyx import screen">
    In the VoiceInfra dashboard, go to **Settings → Phone Numbers → Connect Telnyx**.
  </Step>

  <Step title="Enter your Telnyx API v2 key">
    Paste your API v2 key into the form. The key must start with `KEY`. VoiceInfra encrypts it immediately — it is never stored in plain text, exposed in logs, or used to access your Telnyx billing or account settings.
  </Step>

  <Step title="Browse your available numbers">
    After connecting, your Telnyx numbers appear in a list showing the country code, full number, and friendly name. Confirm your numbers are present before selecting.
  </Step>

  <Step title="Select and import">
    Check the numbers you want to bring into VoiceInfra — one, several, or all of them. Click **Import**. Selected numbers are instantly available in your VoiceInfra dashboard.
  </Step>

  <Step title="Assign to an AI agent">
    For each imported number, choose the AI agent that handles calls on that number. Assign different agents to different numbers, or configure separate agents for inbound and outbound calls.
  </Step>
</Steps>

## Syncing New Numbers

If you add new numbers to Telnyx after the initial import, return to **Settings → Phone Numbers → Connect Telnyx** and re-run the import. VoiceInfra fetches your current number list and makes any new numbers available.

## SIP Trunking Integration

For advanced deployments, VoiceInfra can also integrate directly with Telnyx SIP trunking. This gives you full control over custom call routing, inbound/outbound SIP URI configuration, and IP whitelisting alongside your standard Telnyx number management. See the [SIP Numbers](/docs/channels/sip-numbers) guide for SIP trunk configuration details.

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Will my Telnyx billing change?">
    No. You continue paying Telnyx directly for number rental and call usage. VoiceInfra charges separately for AI usage. There are no additional telephony fees from VoiceInfra.
  </Accordion>

  <Accordion title="Can I sync new Telnyx numbers later?">
    Yes. Return to the Connect Telnyx screen anytime and re-run the import step. Newly added Telnyx numbers appear in the list immediately.
  </Accordion>

  <Accordion title="Does removing a number from VoiceInfra affect Telnyx?">
    No. Removing an imported number from VoiceInfra only unlinks it from your VoiceInfra dashboard. The number continues to exist in your Telnyx account with all its existing configuration.
  </Accordion>

  <Accordion title="What if my API key is incorrect?">
    VoiceInfra shows an error message. Double-check that you are using a **v2 API key** (not a v1 key) from your Telnyx Portal. The key must start with `KEY` and be 64 or more characters long.
  </Accordion>

  <Accordion title="Do imported numbers support international formats?">
    Yes. Any Telnyx number from any country appears in the import list with its country code (e.g., +1, +44, +91) and full number in E.164 format.
  </Accordion>
</AccordionGroup>