Skip to main content
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

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

​
Import a number

Carrier import chooser with Twilio, Telnyx and Vonage options

Settings → Phone numbers → Add a number → Import from your carrier: select your carrier, then Continue to its connection details.

  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.
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.

​
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.
Carrier import is the fastest option for Twilio, Telnyx, and Vonage. For another SIP provider, use BYO SIP trunk.