Vobiz Logo
Vobiz
|API Documentation
Console
← Back to Trunks

Create a Trunk

Create a new SIP trunk for voice communications.

This API allows you to create a new SIP trunk for handling voice traffic. Each trunk can be configured with rate limits, authentication methods (credentials and IP ACLs), and origination URIs for outbound routing.

Auto-Generated Domain: Upon creation, Vobiz automatically generates a unique SIP domain for your trunk in the format: trunk_id.sip.vobiz.ai. This domain is used for routing inbound calls to your trunk.

HTTP Request

POSThttps://api.vobiz.ai/api/v1/account/{account_id}/trunks

Authentication: Bearer token required. Include X-Auth-ID header.

Request Parameters

Request Parameters

NameTypeDescription
nameRequired
stringA descriptive name for the trunk. Maximum 255 characters.
trunk_status
stringStatus of the trunk. e.g. 'enabled', 'disabled'.
secure
booleanWhether the trunk is secure (TLS/SRTP).
trunk_direction
stringDirection of calls. e.g. 'outbound', 'both'.
trunk_domain
stringThe SIP domain for the trunk.
concurrent_calls_limit
integerMaximum number of concurrent calls allowed.
cps_limit
integerCalls per second limit.
transport
stringThe transport protocol to be used. Can be "udp" or "tcp".
ipacl_uuid
stringUUID of the IP Access Control List to associate with this trunk.
credential_uuid
stringUUID of the Credential to associate with this trunk.
primary_uri_uuid
stringUUID of the primary Origination URI.
fallback_uri_uuid
stringUUID of the fallback Origination URI.
inbound_destination
stringThe SIP URI to which inbound calls will be forwarded.

Response

Returns the complete trunk object including the auto-generated trunk_id UUID and timestamps.

Response - 201 Created
{
                "trunk_id": "aabbcc-dd-ee-ff-gg",
                "account_id": "MA_XYZ123",
                "name": "My SIP Trunk",
                "trunk_domain": "sip.example.com",
                "trunk_status": "active",
                "secure": false,
                "trunk_direction": "outbound",
                "concurrent_calls_limit": 10,
                "cps_limit": 5,
                "ipacl_uuid": "YOUR_IP_ACL_ID",
                "credential_uuid": "YOUR_CREDENTIAL_ID",
                "primary_uri_uuid": "YOUR_PRIMARY_URI_ID",
                "fallback_uri_uuid": "YOUR_FALLBACK_URI_ID",
                "transport": "udp",
                "created_at": "2025-11-03T14:09:12.08032875Z",
                "updated_at": "2025-11-03T14:09:12.08032875Z"
              }

Examples

cURL - Basic Trunk

cURL Request
curl -X POST https://api.vobiz.ai/api/v1/account/{Auth_ID}/trunks \
                  -H "X-Auth-ID: YOUR_AUTH_ID" \
                  -H "X-Auth-Token: YOUR_AUTH_TOKEN" \
                  -H "Content-Type: application/json" \
                  -d '{
                    "name": "My SIP Trunk",
                    "trunk_status": "enabled",
                    "secure": false,
                    "trunk_direction": "outbound",
                    "trunk_domain": "sip.example.com",
                    "concurrent_calls_limit": 10,
                    "cps_limit": 5,
                    "transport": "udp",
                    "ipacl_uuid": "{ipAclId}",
                    "credential_uuid": "{credentialId}",
                    "primary_uri_uuid": "{primaryUriId}",
                    "fallback_uri_uuid": "{fallbackUriId}",
                    "inbound_destination": "sip:user@host.com"
                  }'

Next Steps:

  • • Save the trunk_id for all future operations
  • • Add credentials or IP ACLs for authentication
  • • Configure origination URIs for outbound call routing
  • • Test the trunk with a sample call before production use
The Trunk Object
Retrieve a Trunk