Create a SIP trunk

POST

sip-trunks

Create a SIP trunk

curl --request POST \
  --url https://api.phone.wixzel.com/v1/sip-trunks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "host": "<string>",
  "port": 5060,
  "transport": "udp",
  "username": "<string>",
  "password": "<string>",
  "auth_realm": "<string>",
  "default_caller_id": "<string>",
  "dial_prefix": "<string>",
  "send_plus": true,
  "provider_name": "<string>"
}
'

import requests

url = "https://api.phone.wixzel.com/v1/sip-trunks"

payload = {
    "name": "<string>",
    "host": "<string>",
    "port": 5060,
    "transport": "udp",
    "username": "<string>",
    "password": "<string>",
    "auth_realm": "<string>",
    "default_caller_id": "<string>",
    "dial_prefix": "<string>",
    "send_plus": True,
    "provider_name": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    host: '<string>',
    port: 5060,
    transport: 'udp',
    username: '<string>',
    password: '<string>',
    auth_realm: '<string>',
    default_caller_id: '<string>',
    dial_prefix: '<string>',
    send_plus: true,
    provider_name: '<string>'
  })
};

fetch('https://api.phone.wixzel.com/v1/sip-trunks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.phone.wixzel.com/v1/sip-trunks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'host' => '<string>',
    'port' => 5060,
    'transport' => 'udp',
    'username' => '<string>',
    'password' => '<string>',
    'auth_realm' => '<string>',
    'default_caller_id' => '<string>',
    'dial_prefix' => '<string>',
    'send_plus' => true,
    'provider_name' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.phone.wixzel.com/v1/sip-trunks"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"host\": \"<string>\",\n  \"port\": 5060,\n  \"transport\": \"udp\",\n  \"username\": \"<string>\",\n  \"password\": \"<string>\",\n  \"auth_realm\": \"<string>\",\n  \"default_caller_id\": \"<string>\",\n  \"dial_prefix\": \"<string>\",\n  \"send_plus\": true,\n  \"provider_name\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.phone.wixzel.com/v1/sip-trunks")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"host\": \"<string>\",\n  \"port\": 5060,\n  \"transport\": \"udp\",\n  \"username\": \"<string>\",\n  \"password\": \"<string>\",\n  \"auth_realm\": \"<string>\",\n  \"default_caller_id\": \"<string>\",\n  \"dial_prefix\": \"<string>\",\n  \"send_plus\": true,\n  \"provider_name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.phone.wixzel.com/v1/sip-trunks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"host\": \"<string>\",\n  \"port\": 5060,\n  \"transport\": \"udp\",\n  \"username\": \"<string>\",\n  \"password\": \"<string>\",\n  \"auth_realm\": \"<string>\",\n  \"default_caller_id\": \"<string>\",\n  \"dial_prefix\": \"<string>\",\n  \"send_plus\": true,\n  \"provider_name\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "6a96a3ead6e886d42462dd3e",
  "object": "sip_trunk",
  "name": "<string>",
  "host": "<string>",
  "port": 123,
  "transport": "udp",
  "username": "<string>",
  "send_plus": true,
  "platform_ip": "95.216.218.102",
  "origination_uri": "sip:95.216.218.102:5090",
  "provider_name": "<string>",
  "status": "<string>",
  "created_at": "2026-09-01T12:00:00.000Z"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Your Wixzel Phone API key: Authorization: Bearer wv_live_.... Keys are scoped; grant only what the integration needs.

Body

application/json

name

string

required

Required string length: 1 - 64

Pattern: ^[a-zA-Z0-9 _-]+$

host

string

required

Required string length: 1 - 253

Pattern: ^[a-zA-Z0-9.-]+$

port

integer

default:5060

Required range: 1 <= x <= 65535

transport

enum<string>

default:udp

Available options:

udp,

tcp,

tls

username

string

Maximum string length: 128

Pattern: ^[a-zA-Z0-9._-]*$

password

string

Maximum string length: 256

auth_realm

string

Maximum string length: 128

Pattern: ^[a-zA-Z0-9.-]*$

default_caller_id

string

Maximum string length: 64

Pattern: ^[a-zA-Z0-9+ _-]*$

dial_prefix

string

Maximum string length: 16

Pattern: ^[0-9+*#]*$

send_plus

boolean

default:true

Whether to keep the leading "+" when dialling, so the request URI reads sip:+15551234567@host. Twilio and Telnyx expect it. Many wholesale carriers cannot parse it and answer 408 Request Timeout after a few seconds, with the call showing in their portal as received but never answered. Set false to send bare digits instead.

provider_name

string

Maximum string length: 64

Response

The created a SIP trunk

string

required

Pattern: ^[0-9a-f]{24}$

Example:

"6a96a3ead6e886d42462dd3e"

object

enum<string>

required

Available options:

sip_trunk

name

string

required

host

string

required

port

integer

required

transport

enum<string>

required

Available options:

udp,

tcp,

tls

username

string | null

required

send_plus

boolean

required

platform_ip

string | null

required

The address calls are placed from. Allowlist it with your carrier: most authorise outbound calls by source IP, and without it the trunk looks configured while no call completes. Read from the deployment rather than written down, so it cannot go stale. Null if this install has not set it.

Example:

"95.216.218.102"

origination_uri

string | null

required

Where your carrier must send INBOUND calls. Paste it into the field your provider calls the Origination URI (Twilio Elastic SIP Trunking), or the termination point / destination SIP URI — the names differ, the string does not. platform_ip is the outbound half: it tells the carrier to accept calls FROM us. This is the inbound half, and it is separate configuration in a different part of their console. Without it a number is bought, pointed at an agent, and simply never rings, because the carrier has nowhere to deliver the call to. Null if this install has not published a SIP address.

Example:

"sip:95.216.218.102:5090"

provider_name

string | null

required

status

string

required

created_at

string<date-time>

required

ISO 8601, always UTC.

Example:

"2026-09-01T12:00:00.000Z"

⌘I

Create a SIP trunk

curl --request POST \
  --url https://api.phone.wixzel.com/v1/sip-trunks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "host": "<string>",
  "port": 5060,
  "transport": "udp",
  "username": "<string>",
  "password": "<string>",
  "auth_realm": "<string>",
  "default_caller_id": "<string>",
  "dial_prefix": "<string>",
  "send_plus": true,
  "provider_name": "<string>"
}
'

import requests

url = "https://api.phone.wixzel.com/v1/sip-trunks"

payload = {
    "name": "<string>",
    "host": "<string>",
    "port": 5060,
    "transport": "udp",
    "username": "<string>",
    "password": "<string>",
    "auth_realm": "<string>",
    "default_caller_id": "<string>",
    "dial_prefix": "<string>",
    "send_plus": True,
    "provider_name": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    host: '<string>',
    port: 5060,
    transport: 'udp',
    username: '<string>',
    password: '<string>',
    auth_realm: '<string>',
    default_caller_id: '<string>',
    dial_prefix: '<string>',
    send_plus: true,
    provider_name: '<string>'
  })
};

fetch('https://api.phone.wixzel.com/v1/sip-trunks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.phone.wixzel.com/v1/sip-trunks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'host' => '<string>',
    'port' => 5060,
    'transport' => 'udp',
    'username' => '<string>',
    'password' => '<string>',
    'auth_realm' => '<string>',
    'default_caller_id' => '<string>',
    'dial_prefix' => '<string>',
    'send_plus' => true,
    'provider_name' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.phone.wixzel.com/v1/sip-trunks"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"host\": \"<string>\",\n  \"port\": 5060,\n  \"transport\": \"udp\",\n  \"username\": \"<string>\",\n  \"password\": \"<string>\",\n  \"auth_realm\": \"<string>\",\n  \"default_caller_id\": \"<string>\",\n  \"dial_prefix\": \"<string>\",\n  \"send_plus\": true,\n  \"provider_name\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.phone.wixzel.com/v1/sip-trunks")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"host\": \"<string>\",\n  \"port\": 5060,\n  \"transport\": \"udp\",\n  \"username\": \"<string>\",\n  \"password\": \"<string>\",\n  \"auth_realm\": \"<string>\",\n  \"default_caller_id\": \"<string>\",\n  \"dial_prefix\": \"<string>\",\n  \"send_plus\": true,\n  \"provider_name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.phone.wixzel.com/v1/sip-trunks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"host\": \"<string>\",\n  \"port\": 5060,\n  \"transport\": \"udp\",\n  \"username\": \"<string>\",\n  \"password\": \"<string>\",\n  \"auth_realm\": \"<string>\",\n  \"default_caller_id\": \"<string>\",\n  \"dial_prefix\": \"<string>\",\n  \"send_plus\": true,\n  \"provider_name\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "6a96a3ead6e886d42462dd3e",
  "object": "sip_trunk",
  "name": "<string>",
  "host": "<string>",
  "port": 123,
  "transport": "udp",
  "username": "<string>",
  "send_plus": true,
  "platform_ip": "95.216.218.102",
  "origination_uri": "sip:95.216.218.102:5090",
  "provider_name": "<string>",
  "status": "<string>",
  "created_at": "2026-09-01T12:00:00.000Z"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

Getting started

Guides

Concepts

API reference

Authorizations

Body

Response