Skip to content
Contactivity

Bring your own carrier

Bring your own carrier (BYOC) lets you keep the voice carrier and numbers you already have, and use them with our SIP trunks, voice apps and flows.

How it works

  1. 1

    Add your gateways

    Add 1 to 10 outbound gateways over UDP, TCP or TLS, with a login if your carrier needs one. They are tried in order.

  2. 2

    Add your source IPs

    List the addresses your carrier sends calls from. Calls from other addresses are refused.

  3. 3

    Add and route numbers

    Add your carrier's numbers and route each one to a trunk, app or flow. Calls with one of them as caller ID leave through your carrier.

Features

Gateway failover
The next gateway is tried after no answer, a timeout, a server error or a refused login. Busy, not found or declined ends the call.
Source IPs
1 to 50 public IPv4 addresses or ranges, each no wider than /24. Only calls to your carrier's numbers are accepted from them.
Your numbers
Route carrier numbers like any other number. Calls you forward from them leave through the same carrier.
Works with every product
Carrier numbers answer with SIP trunks, voice apps and flows.
Caller ID
Your carrier signs your outbound calls for caller ID.

911 calls from carrier numbers go through your carrier only after you confirm it provides 911. Contactivity does not route or support those calls. Read the emergency calling notice. BYOC needs a verified account.

Add a carrier

curl https://api.contactivity.io/v1/projects/$PROJECT_ID/byoc/carriers \  -H "Authorization: Bearer $CONTACTIVITY_API_KEY" \  -H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \  -d '{    "name": "Acme Telecom",    "gateways": [      {"host": "sip1.acme.example", "port": 5060, "transport": "udp", "priority": 0},      {"host": "sip2.acme.example", "port": 5060, "transport": "udp", "priority": 1}    ],    "source_ips": ["198.51.100.0/28", "203.0.113.7"]  }'

Questions

Can I add a number I bought from Contactivity?

No. Numbers bought from Contactivity always use our network, and cannot be added to a carrier.

How does 911 work on carrier numbers?

911 calls go through your carrier only after you confirm it provides 911, including the caller's location. Until then they are not sent to your carrier. Contactivity does not route or support those calls.

What do I need to use BYOC?

A verified account at Tier 2 or higher, and your carrier's gateways and source IPs.

Start in the sandbox

Try trunks, voice apps and flows with calls to your own verified numbers, before you add a card.

Create an account