# VICIdial carrier setup: add a SIP trunk in 4 steps

> VICIdial carrier setup in the Trustane console: pick the provider, sign in or allow by IP, a dial prefix checked as you type, and the exact entry VICIdial gets.

URL: https://trustane.com/guides/vicidial-carrier-setup-sip-trunk
By Trustane. Published 2026-11-11, updated 2026-11-19.

> **To the point**
> VICIdial carrier setup in admin.php means writing the account entry and the dialplan entry yourself. In the Trustane console, **Carriers**, then **Add carrier**, takes 4 steps and writes both for you:
>
> 1. **Provider**: Twilio, Telnyx, RingCentral or any other SIP provider.
> 2. **Connect**: the SIP server with a username and password, or by IP. On a PJSIP server, a Telnyx API key or a Twilio Account SID and Auth Token is enough: Trustane sets it up on your account.
> 3. **Calls**: the dial prefix, checked on the server as you type, and what the carrier receives.
> 4. **Review**: each step, and the exact carrier entry and dial plan VICIdial gets.

Video: [VICIdial carrier setup: add a SIP trunk in 4 steps, no dial plan to write](https://www.youtube.com/watch?v=-tvYDE9R-9k)

The pictures come from our demo account. The SIP server 198.51.100.25 is in an address range kept for documentation, and the username is made up.

## Open Carriers

1. Open your server, then **Carriers**. Each carrier has a row: its state now, whether it makes or takes calls, and the campaigns that dial through it.
2. Click **Add carrier**.

![The Carriers list with one carrier, Demo Telco, reachable, and the Add carrier button marked](https://trustane.com/media/c7e05fc68b72084e-1600x279.webp "Carriers: one row per carrier, and Add carrier")

## 1. Pick the provider

![The Provider step: Twilio, Telnyx, RingCentral and Other SIP provider](https://trustane.com/media/e29f2cb9abe94e2f-1432x552.webp "Four choices: Twilio, Telnyx, RingCentral or any other SIP provider")

You are not asked whether the carrier is PJSIP or chan_sip. The console uses the server's own: PJSIP where the server takes it, chan_sip where it takes only that.

### Twilio or Telnyx with an API key

On a PJSIP server, Twilio and Telnyx offer **With your API key**. Give Telnyx its API key, or Twilio its Account SID and Auth Token, and press **Fetch**:

- **Telnyx**: a new connection for this server that signs in, or this server added to an IP connection you already have, in the region you pick.
- **Twilio**: a new trunk for this server, or one you already have, with this server's credentials and IP.
- **Numbers**: the account's numbers are listed with their country and where their calls go now. The ones you tick move onto the carrier and arrive on **Numbers**, not routed yet.

![Telnyx picked: With your API key, and the Telnyx API key field](https://trustane.com/media/df9f4eaa510e4143-1432x944.webp "With your API key: Trustane sets it up and fetches the numbers")

**Enter the settings** is there if you would rather set it up in Twilio or Telnyx yourself.

### RingCentral

Paste the phone's SIP details from RingCentral's admin portal (**Phones & Devices**, the phone, **Set up manually using SIP**). The username, password, authorization ID, domain and outbound proxy are filled from them.

## 2. Connect

For any other provider:

1. **Name**: your name for the carrier. VICIdial's carrier ID is made from it.
2. **Username and password** when the provider gave you a SIP login: the carrier signs in with it. Pick **IP address** instead when the provider allows calls by your server's IP.
3. **SIP server**: a host name or IP, with `:port` if it is not 5060.
4. **Username** and **Password**.

![The Connect step filled in: Main carrier, Username and password, SIP server 198.51.100.25, username atlas01 and a hidden password](https://trustane.com/media/0fb408dea954b7d5-1432x1012.webp "Connect: the name, how it signs in, the SIP server and the login")

With **IP address**, the console shows your server's IP with a copy button, to give the provider. In the picture it is blurred.

![IP address picked: Give the provider this server's IP, with the address and a copy button](https://trustane.com/media/7f56166312980b0a-1432x1024.webp "IP address: the provider trusts this server's IP")

**More settings** holds what some providers ask for: the carrier ID, the transport, whether it signs in, an auth username, the addresses calls come in from, an outbound proxy, the From user and From domain, and the codecs. ulaw and alaw are ticked to start; g729, g722 and opus are there to add.

![More settings: Carrier ID MAIN_CARRIER, Transport UDP, From user, and the codecs ulaw and alaw ticked](https://trustane.com/media/c88c73a2e44a6657-1432x926.webp "More settings, for providers that ask for them")

## 3. Calls: the dial prefix

Pick **Both**, **Outbound** or **Inbound**. For outbound, the carrier needs a dial prefix. In VICIdial, a campaign reaches a carrier by its **Dial Prefix**: the campaign puts the prefix before the number, and the carrier's dial plan takes the numbers that start with it and drops the prefix.

1. **Dial prefix**: 1 to 4 digits, not starting with 0 or 8, which start VICIdial's own extensions, or 1, which is how a campaign with no prefix dials. The console suggests a free one, and checks what you type on the server: against every carrier's dial plan, and against what Asterisk already reaches with it. Here 9 is taken by the carrier DEMOTELCO, so it offers 7.

   ![Dial prefix 9: Taken by DEMOTELCO, with a link to use 7](https://trustane.com/media/a2ff160b4e6d75ba-1432x860.webp "9 is taken on this server, so it offers 7")

2. **Tech prefix**: digits the carrier wants before each number, if it wants any.
3. **Number sent as**: as dialled, `15551234567`, or with a plus, `+15551234567`.
4. **Campaigns to move to it, once it works**: tick the campaigns that should dial through the new carrier.

The line above the campaigns shows the result: the campaign dials `715551234567`, and MAIN_CARRIER gets `15551234567`. Inbound calls go to your **Numbers**, where you add each number.

![Dial prefix 7, Free on this server; Campaign dials 715551234567, MAIN_CARRIER gets 15551234567; BLENDED ticked](https://trustane.com/media/8fa3b453292c705e-1432x1102.webp "7 is free; what the carrier receives; the campaign to move")

## 4. Review, then Add carrier

**Review** lists what happens, in order: the PJSIP carrier MAIN_CARRIER, signing in as atlas01; Asterisk loading it; outbound, 7 and the number to 198.51.100.25; inbound calls to your Numbers; and BLENDED moving to 7 once it works.

**What VICIdial gets** opens the exact text the console writes into VICIdial: the carrier's account entry and its three dial plan lines. The password shows as `********`.

![Review: the five steps, and What VICIdial gets open with the PJSIP wizard lines, the password masked, and the dial plan for 7](https://trustane.com/media/bedc78ab666d1fa1-1432x1498.webp "Review: what happens, and the exact entry and dial plan")

**Add carrier** writes the carrier to VICIdial, and Asterisk loads it in about a minute. The sheet stays open and shows its state as Asterisk reports it: **Signed in**, **Reachable**, **Sign-in refused** or **Not reachable**. Once Asterisk has loaded it, **Move BLENDED to it** sets the campaign's dial prefix. Wait until it is signed in or reachable first, or calls on that campaign fail.

> **What the move does not change**
> - **Manual Dial Prefix and 3-Way Dial Prefix.** A campaign with either one set keeps those calls on its own prefix. Left blank, they follow the Dial Prefix.
> - **Caller ID.** The carrier has to accept the campaign's caller ID, or it refuses the call. The move neither changes nor checks it.

## Carriers made in admin.php

A carrier made in admin.php shows in the same list. Right-click it and pick **Take over…** to open it in the same steps. Saving rewrites it the way the console writes carriers, and Review lists every line it has now that is not kept. [Setting up a PJSIP carrier in VICIdial on Asterisk 22](https://trustane.com/guides/vicidial-pjsip-carrier-setup-asterisk-22) shows admin.php's carrier fields and what VICIdial does with each.

## Questions people ask

### PJSIP or chan_sip?

The server's own. The console offers PJSIP where VICIdial and Asterisk on the server take it, and chan_sip where they take only that. Asterisk 21 removed chan_sip, so [moving a carrier from chan_sip to PJSIP](https://trustane.com/guides/vicidial-chan-sip-to-pjsip-carrier) explains what changes.

### Can I change a carrier later?

Yes. Right-click it and pick **Change**. Its ID stays. If the change takes away a prefix that campaigns dial with, Review names those campaigns and offers to move them.

### Why does the dial prefix not start with 0, 1 or 8?

Numbers starting with 0 or 8 are VICIdial's own extensions, and 1 is the country code a campaign with no prefix dials, so the console refuses all three and suggests 9, then 7, 6, 5 and on.

## Next steps

- [Moving a VICIdial carrier from chan_sip to PJSIP](https://trustane.com/guides/vicidial-chan-sip-to-pjsip-carrier) and [carrier failover on Asterisk 22](https://trustane.com/blog/vicidial-carrier-failover-asterisk-22).
- [SIP codes that mean the carrier is down, or the number is bad](https://trustane.com/blog/sip-codes-carrier-down-or-bad-number).
- [Order a server](https://trustane.com/order) and add your carrier.

VICIdial is a trademark of its owner. Trustane is an independent hosting provider. Twilio, Telnyx and RingCentral are trademarks of their owners. Trustane is not affiliated with them.
