Skip to main content
POST
Link a BYOC phone number with SIP trunk credentials (V1 alias)
Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. Use the /v1 version for new integrations. This endpoint remains available for existing integrations until then.
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.

Authorizations

Authorization
string
header
required

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

Headers

x-organization-id
string
required

RSA encrypted organization ID (base64 format)

Example:

"BASE64_ENCRYPTED_ORG_ID_HERE"

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 and registered with media server.