SIP Trunks API overview

Session Initiation Protocol (SIP) is a signaling protocol for starting, ending, and changing user sessions over an IP network. The Wavix platform provides scalable, enterprise-level features for inbound and outbound calls. This guide shows you how to create and configure SIP trunks on your Wavix account using the Wavix API.

Prerequisites

Before you create your first SIP trunk, sign up for a Wavix account.

Create a Wavix account

Sign up for a Wavix account using your business email address.
Confirm your email address and phone number during the sign-up process.
Wait for your account to be approved by the Wavix team.
After approval, choose either the Wavix Flex or Flex Pro account level.

Once your account is approved, you can access the Wavix app and APIs.

Find your API key

Get your API key

List SIP trunks on your Wavix account

To list SIP trunks and view their statuses on your Wavix account, use the following method:

GET https://api.wavix.com/v1/trunks
Authorization: Bearer your_api_key
Content-Type: application/json

Create and configure SIP trunks

The Wavix platform supports these authentication methods for SIP trunks:

Digest - SIP devices authenticate with a login and password.
IP Authentication - The SIP trunk authenticates SIP INVITE messages sent from specified IP addresses. IP Authentication requires manual approval by Wavix administrators.

For outbound calls, Wavix supports one Caller ID per SIP trunk by default. To use more than one Caller ID, enable Caller ID Passthrough. Caller ID Passthrough requires manual approval by Wavix administrators.

To create a SIP trunk on your account, use this API method:

POST https://api.wavix.com/v1/trunks
Authorization: Bearer your_api_key
Content-Type: application/json

Response:

{
    "label": "My SIP trunk",
    "password": "YOUR_SIP_TRUNK_PASSWORD",
    "callerid": "12121234567",
    "ip_restrict": false,
    "didinfo_enabled": true,
    "call_restrict": true,
    "call_limit": 60,
    "cost_limit": true,
    "max_call_cost": 0.18,
    "channels_restrict": true,
    "max_channels": 10,
    "rewrite_enabled": true,
    "rewrite_prefix": "00",
    "rewrite_cond": "1",
    "passthrough": false
}

After you create the SIP trunk, you receive a response with the SIP trunk ID and its configuration parameters. To update a SIP trunk configuration, use this API method:

PUT https://api.wavix.com/v1/trunks/trunk_id
Authorization: Bearer your_api_key
Content-Type: application/json

Paste the following JSON in the request body.

{
    "label": "SIP trunk label",
    "password": "YOUR_SIP_TRUNK_PASSWORD",
    "callerid": "12121234567",
    "ip_restrict": true,
    "didinfo_enabled": true,
    "call_restrict": false,
    "call_limit": 60,
    "cost_limit": true,
    "max_call_cost": 0.18,
    "channels_restrict": true,
    "max_channels": 10,
    "rewrite_enabled": true,
    "rewrite_prefix": "00",
    "rewrite_cond": "1",
    "passthrough": false
}

Delete a SIP trunk

To delete a SIP trunk from your account, use this API method:

DELETE https://api.wavix.com/v1/trunks/trunk_id
Authorization: Bearer your_api_key
Content-Type: application/json

Getting started

Messaging

Voice

Numbers

AI integrations

SIP Trunks API overview

Prerequisites

Create a Wavix account

Find your API key

List SIP trunks on your Wavix account

Create and configure SIP trunks

Delete a SIP trunk

​Prerequisites

​Create a Wavix account

​Find your API key

​List SIP trunks on your Wavix account

​Create and configure SIP trunks

​Delete a SIP trunk

Prerequisites

Create a Wavix account

Find your API key

List SIP trunks on your Wavix account

Create and configure SIP trunks

Delete a SIP trunk