Create SIP trunk

POST

sip-trunks

trunks

curl --request POST \
  --url https://api.bolna.ai/sip-trunks/trunks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Zadarma Production",
  "provider": "zadarma",
  "description": "Main trunk for outbound sales",
  "auth_type": "userpass",
  "auth_username": "<your-sip-username>",
  "auth_password": "<your-sip-password>",
  "gateways": [
    {
      "gateway_address": "sip.zadarma.com",
      "port": 5060,
      "priority": 1
    }
  ],
  "allow": "ulaw,alaw",
  "disallow": "all",
  "inbound_enabled": true,
  "outbound_leading_plus_enabled": true
}
'

{
  "id": "<string>",
  "name": "<string>",
  "provider": "<string>",
  "description": "<string>",
  "auth_type": "userpass",
  "auth_username": "<string>",
  "gateways": [
    {
      "gateway_address": "sip.zadarma.com",
      "port": 5060,
      "priority": 1
    }
  ],
  "ip_identifiers": [
    {
      "ip_address": "15.207.90.192/31"
    }
  ],
  "phone_numbers": [
    {
      "id": "<string>",
      "phone_number": "<string>",
      "name": "<string>",
      "byot_trunk_id": "<string>",
      "telephony_provider": "sip-trunk",
      "deleted": true,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "allow": "<string>",
  "disallow": "<string>",
  "transport": "transport-udp",
  "direct_media": true,
  "rtp_symmetric": true,
  "force_rport": true,
  "media_encryption": "no",
  "media_encryption_optimistic": true,
  "qualify_frequency": 123,
  "inbound_enabled": true,
  "outbound_leading_plus_enabled": true,
  "is_active": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "error": 123,
  "message": "<string>"
}

Legacy SIP trunks (deprecated). These /sip-trunks endpoints manage legacy SIP trunks. Existing legacy trunks keep working, but use the SIP trunks API for every new setup, and see Migrate to SIP trunks to move an existing trunk.

Next steps

After creating your trunk, add a phone number to it.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

SIP trunk configuration

name

string

required

Human-readable label. Must be unique per account.

Example:

"Zadarma Production"

provider

string

required

SIP provider name (e.g. twilio, plivo, zadarma, telnyx, vonage, custom)

Example:

"zadarma"

auth_type

enum<string>

required

Authentication method

Available options:

userpass,

ip-based

Example:

"userpass"

gateways

object[]

required

At least one gateway is required

Show child attributes

description

string

Optional description for internal reference

auth_username

string

SIP username. Required when auth_type is userpass.

auth_password

string

SIP password. Required when auth_type is userpass.

ip_identifiers

object[]

Required when auth_type is ip-based

Show child attributes

allow

string

default:ulaw,alaw

Comma-separated codecs to allow

disallow

string

default:all

Comma-separated codecs to disallow

transport

enum<string>

default:transport-udp

SIP transport protocol.

Available options:

transport-udp,

transport-tcp,

transport-tls

direct_media

boolean

default:false

RTP directly between caller and callee. Keep false.

rtp_symmetric

boolean

default:true

Symmetric RTP. Required for NAT.

force_rport

boolean

default:true

Force responses to source port. Required for NAT.

media_encryption

enum<string>

default:no

RTP encryption. Use "sdes" for SRTP. Requires transport=transport-tls.

Available options:

no,

sdes

media_encryption_optimistic

boolean

default:false

When media_encryption=sdes, fall back to clear RTP if the carrier does not offer crypto in its SDP.

qualify_frequency

integer

default:60

SIP OPTIONS ping interval in seconds. 0 to disable.

inbound_enabled

boolean

default:false

Set true to receive inbound calls on this trunk

outbound_leading_plus_enabled

boolean

default:true

Prepend + to outbound dialed numbers

phone_numbers

object[]

Optional phone numbers to add at creation time

Show child attributes

Response

SIP trunk created successfully

SIP trunk object returned by the API.

string

Unique SIP trunk identifier.

name

string

Human-readable trunk name.

provider

string

SIP provider name (e.g., twilio, plivo, zadarma, telnyx, vonage, custom).

description

string

Optional trunk description for internal reference.

auth_type

enum<string>

Authentication method used for this trunk.

Available options:

userpass,

ip-based

auth_username

string

SIP username (present only for userpass trunks).

gateways

object[]

Ordered list of SIP gateways used for registration and call routing.

Show child attributes

ip_identifiers

object[]

IP ranges associated with this trunk (used only for ip-based authentication).

Show child attributes

phone_numbers

object[]

Phone numbers (DIDs) registered on this trunk.

Show child attributes

allow

string

Comma-separated codecs to allow.

disallow

string

Comma-separated codecs to disallow.

transport

enum<string>

SIP transport used by the trunk.

Available options:

transport-udp,

transport-tcp,

transport-tls

direct_media

boolean

Whether RTP is routed directly between endpoints (typically false).

rtp_symmetric

boolean

Enables symmetric RTP to handle NAT.

force_rport

boolean

Forces responses to the source port to handle NAT.

media_encryption

enum<string>

RTP encryption mode. "no" for plain RTP, "sdes" for SRTP via SDES (TLS trunks only).

Available options:

no,

sdes

media_encryption_optimistic

boolean

When media_encryption=sdes, whether to fall back to clear RTP if the carrier does not offer crypto.

qualify_frequency

integer

SIP OPTIONS ping interval in seconds.

inbound_enabled

boolean

Whether inbound calling is enabled.

outbound_leading_plus_enabled

boolean

Whether to prepend a leading + to outbound dialed numbers.

is_active

boolean

Whether the trunk is active.

created_at

string<date-time>

ISO timestamp when the trunk was created.

updated_at

string<date-time>

ISO timestamp when the trunk was last updated.

curl --request POST \
  --url https://api.bolna.ai/sip-trunks/trunks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Zadarma Production",
  "provider": "zadarma",
  "description": "Main trunk for outbound sales",
  "auth_type": "userpass",
  "auth_username": "<your-sip-username>",
  "auth_password": "<your-sip-password>",
  "gateways": [
    {
      "gateway_address": "sip.zadarma.com",
      "port": 5060,
      "priority": 1
    }
  ],
  "allow": "ulaw,alaw",
  "disallow": "all",
  "inbound_enabled": true,
  "outbound_leading_plus_enabled": true
}
'

{
  "id": "<string>",
  "name": "<string>",
  "provider": "<string>",
  "description": "<string>",
  "auth_type": "userpass",
  "auth_username": "<string>",
  "gateways": [
    {
      "gateway_address": "sip.zadarma.com",
      "port": 5060,
      "priority": 1
    }
  ],
  "ip_identifiers": [
    {
      "ip_address": "15.207.90.192/31"
    }
  ],
  "phone_numbers": [
    {
      "id": "<string>",
      "phone_number": "<string>",
      "name": "<string>",
      "byot_trunk_id": "<string>",
      "telephony_provider": "sip-trunk",
      "deleted": true,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "allow": "<string>",
  "disallow": "<string>",
  "transport": "transport-udp",
  "direct_media": true,
  "rtp_symmetric": true,
  "force_rport": true,
  "media_encryption": "no",
  "media_encryption_optimistic": true,
  "qualify_frequency": 123,
  "inbound_enabled": true,
  "outbound_leading_plus_enabled": true,
  "is_active": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "error": 123,
  "message": "<string>"
}

Get started

Voice agents

Telephony

Workflows

Account

Legacy

Next steps

Authorizations

Body

Response

​Next steps

Authorizations

Body

Response

Next steps