Bring Your Own Phone Number

Overview

You aren't limited to numbers provisioned directly through Sulus. You can bring in numbers you already own from another phone number provider, or connect a SIP trunk from your carrier of choice. You can also provision a free Sulus-provided number for quick setup.

Sulus provides free phone numbers for US national use. You can create one from the Phone Numbers section of the dashboard, or via the phone numbers API endpoint.

Free numbers are limited to US national use, and accounts are limited to a maximum of 10 free numbers.

For international numbers, or numbers you already manage with another phone number provider, you can import an existing number.

1. Purchase or confirm the phone number with your provider, if you don't already have one.
2. Get your account credentials from your provider's console (account SID/ID and auth token, or equivalent).
3. In the dashboard, go to Phone Numbers and click Import.
4. Enter the phone number and your provider credentials, then click Import.

Once imported, the number is ready for inbound or outbound calls. This can also be done via the phone-numbers import API endpoint.

Some providers require an extra step to enable outbound calling on an imported number.

1. Go to the Phone Numbers tab in the dashboard.
2. Click Create a Phone Number.
3. Select your provider's tab and enter your phone number details. You'll need an active account with the number already provisioned there.

To enable outbound calling on a number sourced this way:

1. Log in to your provider's portal and find its outbound voice profiles section.
2. Create or edit an Outbound Voice Profile.
3. Under "Connections and Applications," add Sulus as a connection.
4. Save your changes.

For advanced telephony setups, you can bring your own SIP trunk from your carrier of choice.

1. Create a SIP trunk credential using the credential endpoint with "provider": "byo-sip-trunk", specifying your gateways for inbound and outbound routing.
2. Register your phone number using the phone-number endpoint with "provider": "byo-phone-number" and your credentialId.

curl -X POST https://api.sulus.ai/phone-number \
  -H "Authorization: Bearer YOUR_SULUS_PRIVATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "byo-phone-number",
    "name": "My SIP Number",
    "number": "+14155550123",
    "numberE164CheckEnabled": true,
    "credentialId": "YOUR_CREDENTIAL_ID",
    "assistantId": "YOUR_ASSISTANT_ID"
  }'

You'll need to whitelist the following in your SIP trunk provider's settings:

Numbers from other SIP-capable providers are connected the same way — as a BYO SIP trunk credential with your provider's gateway details, followed by registering the number against that credential.