Create Trunk

7 min

Creates a new SIP trunk. This is the first step for all SIP Trunking use cases.

A SIP Trunk acts as a virtual connection between your communication system (PBX/Contact Center) and Exotel's telephony network.

HTTP Request

POST https://<your_api_key>:<your_api_token>@<subdomain>/v2/accounts/<your_sid>/trunks

Request Headers

Header	Value
Content-Type	application/json

Request Parameters

The following parameters are sent as JSON in the body of the request:

Parameter Name	Mandatory/Optional	Value
trunk_name	Mandatory	String; Unique identifier for the trunk. Must be alphanumeric with underscores only, maximum 16 characters. Example: outbound_trunk, my_pbx_trunk
nso_code	Mandatory	String; Network Service Operator code. Use ANY-ANYfor standard configuration.
domain_name	Mandatory	String; SIP domain for the trunk. Format: <your_sid>.pstn.exotel.com. Example: ameyo5m.pstn.exotel.com

Example Request

curl -s -X POST "https://<your_api_key>:<your_api_token>@<subdomain>/v2/accounts/<your_sid>/trunks" \ -H "Content-Type: application/json" \ -d '{ "trunk_name": "outbound_trunk", "nso_code": "ANY-ANY", "domain_name": "<your_sid>.pstn.exotel.com" }'

HTTP Response

On success, the HTTP response status code will be 200 OK.

The trunk_sidis the unique identifier of the trunk - save this value as it will be required for all subsequent API calls.

Example Response

{ "request_id": "10a67da360d446378d5c2b66407b7f18", "method": "POST", "http_code": 200, "response": { "code": 200, "error_data": null, "status": "success", "data": { "trunk_name": "outbound_trunk", "date_created": "2026-01-23T09:24:59Z", "date_updated": "2026-01-23T09:24:59Z", "trunk_sid": "trmum1f708622631150902801a1n", "status": "active", "domain_name": "ameyo5m.pstn.exotel.com", "auth_type": "IP-WHITELIST", "registration_enabled": "disabled", "edge_preference": "auto", "nso_code": "ANY-ANY", "secure_trunking": "disabled", "destination_uris": "/v2/accounts/ameyo5m/trunks/trmum1f708622631150902801a1n/destination-uris", "whitelisted_ips": "/v2/accounts/ameyo5m/trunks/trmum1f708622631150902801a1n/whitelisted-ips", "credentials": "/v2/accounts/ameyo5m/trunks/trmum1f708622631150902801a1n/credentials", "phone_numbers": "/v2/accounts/ameyo5m/trunks/trmum1f708622631150902801a1n/phone-numbers" } } }

Response Parameters

Parameter Name	Type & Value
request_id	String; Unique identifier for this API request
method	String; HTTP method used (POST)
http_code	Integer; HTTP status code (200 for success)
trunk_sid	String; Important - Unique identifier for the trunk. Save this for subsequent API calls. Example: trmum1f708622631150902801a1n
trunk_name	String; Name of the trunk as provided in request
domain_name	String; SIP domain for the trunk
status	String; Current trunk status: active- Trunk is ready for use, inactive- Trunk is disabled
auth_type	String; Authentication type. Currently only IP-WHITELISTis supported
registration_enabled	String; SIP registration status: enabledor disabled
edge_preference	String; Edge server preference. Default: auto
nso_code	String; Network Service Operator code
secure_trunking	String; TLS status: enabledor disabled
destination_uris	String; API path to manage destination URIs for this trunk
whitelisted_ips	String; API path to manage ACLs (whitelisted IPs) for this trunk
credentials	String; API path to credentials for this trunk
phone_numbers	String; API path to manage phone numbers for this trunk
date_created	String; ISO 8601 timestamp when trunk was created
date_updated	String; ISO 8601 timestamp when trunk was last updated