Skip to main content
POST
/
api
/
v1
/
sip-trunks
curl -X POST "https://app.talkover.ai/api/v1/sip-trunks" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Primary Carrier — US",
    "provider_name": "carrier-x",
    "domain": "sip.carrier-x.com",
    "username": "user_42",
    "password": "secret-password",
    "port": 5061,
    "transport": "tls"
  }'

{
  "success": true,
  "data": {
    "id": "trunk-uuid-1",
    "name": "Primary Carrier — US",
    "provider_name": "carrier-x",
    "domain": "sip.carrier-x.com",
    "transport": "tls",
    "port": 5061,
    "is_active": false,
    "is_verified": false,
    "created_at": "2024-01-15T14:00:00Z"
  }
}

​
Create SIP Trunk

Register a custom SIP trunk for your environment. Once created, you must verify the trunk via Verify SIP Trunk before it can be used.
This feature is available only on plans where allow_custom_sip_trunks is enabled.

​
Endpoint

POST /api/v1/sip-trunks

​
Request headers

​
Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here
​
Content-Type
string
required
Must be set to application/json

​
Request body

​
name
string
required
Human-readable trunk name. Max 255 characters.
​
provider_name
string
required
Identifier of your carrier or SIP provider.
​
domain
string
required
SIP domain or proxy host (e.g., sip.carrier-x.com).
​
username
string
required
SIP authentication username.
​
password
string
required
SIP authentication password. Stored encrypted.
​
port
integer
SIP port. Range: 1–65535. Default depends on transport (5060 UDP/TCP, 5061 TLS).
​
transport
string
Transport protocol. Options: udp, tcp, tls. Default: tls.
​
outbound_proxy
string
Optional outbound proxy host.
​
auth_realm
string
Optional SIP auth realm if your carrier requires one.
​
is_active
boolean
Whether the trunk is active. Default: false (you must verify before activating).

​
Examples

curl -X POST "https://app.talkover.ai/api/v1/sip-trunks" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Primary Carrier — US",
    "provider_name": "carrier-x",
    "domain": "sip.carrier-x.com",
    "username": "user_42",
    "password": "secret-password",
    "port": 5061,
    "transport": "tls"
  }'

​
Response

{
  "success": true,
  "data": {
    "id": "trunk-uuid-1",
    "name": "Primary Carrier — US",
    "provider_name": "carrier-x",
    "domain": "sip.carrier-x.com",
    "transport": "tls",
    "port": 5061,
    "is_active": false,
    "is_verified": false,
    "created_at": "2024-01-15T14:00:00Z"
  }
}

​
Notes

  • password is never returned in responses after creation.
  • Run Verify SIP Trunk to test connectivity before activating.