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

# Carrier number import

> Import existing Twilio, Telnyx, or Vonage numbers with automatic SIP routing

Carrier import connects your own carrier account, discovers its existing phone numbers, and creates the matching inbound and outbound SIP configuration automatically. The carrier continues to bill number rental and call termination.

## Supported carriers

| Carrier | Credentials | Inbound setup | Outbound setup |
| - | - | - | - |
| Twilio | Account SID + Auth Token | Elastic SIP Trunk origination URI | Generated trunk credentials |
| Telnyx | API key | FQDN connection to the selected SIP region | `sip.telnyx.com` and generated credentials |
| Vonage | API key + API secret | Direct Numbers API SIP forwarding | `sip.nexmo.com` with API key/secret |

Secrets are encrypted at rest and are never returned by the dashboard, Public API, or MCP.

## Import a number

<Frame caption="Settings → Phone numbers → Add a number → Import from your carrier: select your carrier, then Continue to its connection details.">
  <img src="https://mintcdn.com/ouraicall/in65rcKkEfEQesee/images/guide-ui/carrier-import-options.png?fit=max&auto=format&n=in65rcKkEfEQesee&q=85&s=403d00908ca296b66203b704d53190d3" alt="Carrier import chooser with Twilio, Telnyx and Vonage options" width="640" height="425" data-path="images/guide-ui/carrier-import-options.png" />
</Frame>

1. Open **Settings → Phone numbers → Add a number → Import from your carrier**.
2. Select the carrier, enter credentials, and choose the SIP region.
3. Select voice-capable numbers that are not already routed elsewhere.
4. Import the numbers and assign an assistant.
5. Test one inbound and one outbound call before using the number in a campaign.

The platform re-reads each selected number from the carrier before importing it. A client-supplied number can therefore never be paired with a different carrier resource.

For Telnyx, every import also allows outbound calls to the countries of the connection's numbers in its Outbound Voice Profile (Telnyx allows only the US and Canada by default). Premium and high-risk ranges are never enabled automatically. Add any other destination countries in Telnyx.

The SIP address, credentials, and caller ID format of an imported number are managed by its connection and can't be edited on the number.

## Vonage routing protection

Vonage numbers with an existing app, telephone, or unrelated SIP callback are marked as unavailable. Carrier import never overwrites that routing.

When a Vonage number is removed, its callback is cleared only if it still points to the exact regional SIP endpoint configured by this connection. A callback changed later in Vonage is preserved.

<Warning>
  Do not remove or replace the carrier-side trunk, connection, or callback while a number is active. Use **Troubleshoot** to detect and safely repair supported drift.
</Warning>

## SIP regions and troubleshooting

The selected region determines the SIP endpoint used for inbound signaling. Changing it runs provider diagnostics and repairs imported-number routing.

**Troubleshoot** verifies:

* carrier credentials and account balance;
* provider trunk/connection or direct number routing;
* for Telnyx, that the connection still accepts the platform's SIP credentials and allows calls to your numbers' countries;
* that every imported number sends its SIP credentials and an international caller ID on outbound calls;
* inbound and outbound connectivity;
* number and assistant assignments.

Repairs are limited to resources owned by the selected connection. Provider errors remain visible on the connection.

## Public API and MCP

The Public API exposes:

* `GET/POST /api/v1/carrier-connections`
* `GET/PATCH/DELETE /api/v1/carrier-connections/{id}`
* `GET /api/v1/carrier-connections/{id}/available-numbers`
* `POST /api/v1/carrier-connections/{id}/import`
* `DELETE /api/v1/carrier-connections/{id}/numbers/{numberId}`
* `POST /api/v1/carrier-connections/{id}/troubleshoot`

Use the `sip_trunks:read` or `sip_trunks:write` scope. Equivalent MCP tools are `list_carrier_connections`, `create_carrier_connection`, `get_carrier_connection`, `update_carrier_connection`, `list_carrier_available_numbers`, `import_carrier_numbers`, `remove_carrier_number`, `delete_carrier_connection`, and `troubleshoot_carrier_connection`.

<Tip>
  Carrier import is the fastest option for Twilio, Telnyx, and Vonage. For another SIP provider, use [BYO SIP trunk](/telephony/sip-trunks).
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.