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"
}
}
Custom SIP Trunks
Create SIP Trunk
Register a custom SIP trunk for your environment
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
string
required
Bearer token. Format:
Bearer talq_your_environment_token_herestring
required
Must be set to
application/jsonRequest body
string
required
Human-readable trunk name. Max 255 characters.
string
required
Identifier of your carrier or SIP provider.
string
required
SIP domain or proxy host (e.g.,
sip.carrier-x.com).string
required
SIP authentication username.
string
required
SIP authentication password. Stored encrypted.
integer
SIP port. Range:
1–65535. Default depends on transport (5060 UDP/TCP, 5061 TLS).string
Transport protocol. Options:
udp, tcp, tls. Default: tls.string
Optional outbound proxy host.
string
Optional SIP auth realm if your carrier requires one.
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
passwordis never returned in responses after creation.- Run Verify SIP Trunk to test connectivity before activating.
Was this page helpful?