Phone Numbers
Link SIP Trunk
Link a BYOC number with SIP trunk credentials.
POST
Link SIP Trunk
Changes state - verify before retry
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.
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.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.
400 Bad Request means the trunk credentials or number failed validation; see Errors for the standard error format.
Related endpoints
- SIP Trunking: configure BYOC routing in the dashboard.
- Buy Phone Number: purchase a provider number instead.
- Delete Phone Number: remove the SIP trunk number and routing credentials.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
E.164 phone number
Example:
"+14155552671"
SIP termination host[:port]; must not use a sip: URI prefix
Example:
"31974861099010243.zt.plivo.com:5060"
SIP authentication username
SIP authentication password (stored encrypted)
Display nickname for this trunk
Response
SIP trunk linked successfully.
Link SIP Trunk