Skip to main content
POST
Link SIP Trunk
Changes state - verify before retry
Recommended. This endpoint is part of the public /v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.
Links a bring-your-own phone number to SIP trunk credentials and registers it for DialNexa routing. Use this path for SIP or BYOC numbers that were not purchased through DialNexa.

When to use this

  • Keeping an existing number: your business number already lives with another carrier and you want DialNexa agents to answer or dial from it.
  • Regulatory or cost constraints: your carrier relationship must stay in place, so purchasing through Buy Phone Number is not an option.
  • Migrating call infrastructure: route existing SIP trunks through DialNexa without renumbering.
Calls on SIP trunk routes skip the Telephony Config destination checks that apply to provider numbers, since routing is governed by your trunk. A 400 Bad Request means the trunk credentials or number failed validation; see Errors for the standard error format.

Authorizations

Authorization
string
header
required

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

Body

application/json
phoneNumber
string
required

E.164 phone number

Example:

"+14155552671"

terminationUri
string
required

SIP termination host[:port]; must not use a sip: URI prefix

Example:

"31974861099010243.zt.plivo.com:5060"

sipTrunkUserName
string

SIP authentication username

sipTrunkPassword
string

SIP authentication password (stored encrypted)

nickname
string

Display nickname for this trunk

Response

SIP trunk linked successfully.