Create a Trunk
Provision a new Vobiz SIP trunk with concurrent-call limits, CPS caps, TLS/SRTP, credentials, IP ACLs, and origination URIs - all in a single API call.
X-Auth-ID- Your account Auth IDX-Auth-Token- Your account Auth TokenContent-Type: application/json
trunk_id.sip.vobiz.ai. This domain is used for routing inbound calls to your trunk.Request Parameters
Only three fields are required to create a trunk. The rest of the trunk’s configuration - transport, TLS/SRTP, recording, attached credentials, IP ACLs, and origination URIs - is applied afterwards through the dedicated endpoints or the Console.| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Descriptive name for the trunk. Maximum 255 characters. |
trunk_type | string | Yes | Trunk direction. One of INBOUND or OUTBOUND (uppercase). Determines how the trunk routes traffic. |
max_concurrent_calls | integer | Yes | Maximum number of simultaneous calls. Returned on the trunk object as concurrent_calls_limit. |
cps_limit: 2, secure: false, transport: udp, and trunk_status: active. The trunk_domain is auto-generated as {trunk_id}.sip.vobiz.ai. Tune limits later with Update a Trunk, and attach auth and routing with Credentials, IP ACLs, and Origination URIs.Examples
Response
Returns the complete trunk object, including the auto-generatedtrunk_id UUID and timestamps.
Authorizations
Your Vobiz account Auth ID
Your Vobiz account Auth Token
Path Parameters
Your account Auth ID
"MA_XXXXXX"
Body
Trunk name.
100Direction of the trunk — inbound or outbound only (a trunk is one direction, not both).
inbound, outbound Trunk status — enabled or disabled (note: not active).
enabled, disabled SIP domain. Auto-generated as {first8ofUUID}.sip.vobiz.ai if omitted.
255udp, tcp, tls 255500Stored on the trunk. The enforced concurrency limit is account-level (account base + channel subscriptions), not this field.
0 <= x <= 1000Stored on the trunk. The enforced CPS is account-level, not this field.
0 <= x <= 100Attach an existing SIP credential (username / password / realm) by UUID.
Attach an existing IP access-control list (IP-based auth) by UUID.
Primary origination URI UUID.
Fallback origination URI UUID.
Enable call recording.
Auto-transcribe recordings when recording=true.
Redact PII from transcriptions.
Comma-separated list of entity types to redact.
Customer webhook for call-admission events (CallInitiated / Hangup).
Must be a valid public http/https URL. SSRF-validated — localhost,
private (RFC1918), and cloud-metadata (169.254.169.254) URLs are
rejected with invalid webhook_url. See Trunk Webhooks.
500"https://example.com/vobiz/webhook"
HTTP method for the webhook callback.
POST, GET Fire a recording.completed webhook to webhook_url after a recording is saved.
Deprecated — use credential_uuid.
100Deprecated — use credential_uuid.
100Deprecated — use ipacl_uuid.
Response
Success