Create an inbound SIP trunk
Provision a customer-provided SIP trunk that terminates inbound PSTN onto this org’s DIDs. authMode chooses the gate: ip_allowlist (source-IP check only), digest (server-minted digest credentials), or both (IP + digest). With ip_allowlist or both, every entry in allowedIps must be a valid IPv4 CIDR. allowedCallerIds constrains caller-ids accepted inbound. Optional routingRules attaches a destination blocklist / caller-id rewrite / time window / CDR webhook contract per trunk. On success the response conveys the one-time digest credential bundle when digest auth is in play. Requires owner/admin.
Authorizations
Dashboard JWT token from Clerk
Headers
Stripe-style idempotency token. Pass a stable, client-generated value (1-255 chars) to dedupe retries on transient timeouts. The same key+credential+path replays the original response for 24h on 2xx (5min on 4xx, 30s on 5xx). Returns 409 if a concurrent request with the same key is already in flight; replayed responses include the Idempotency-Replay: true response header.
1 - 255Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.
true, false Body
Display name.
1 - 120Whether inbound traffic is accepted (default true).
Inbound gate: source-IP check, digest credentials, or both.
ip_allowlist, digest, both IPv4 CIDRs allowed to originate inbound calls (required for ip_allowlist / both).
50E.164 caller-ids this trunk may present inbound. Empty = any.
100Optional per-trunk concurrency / hourly / daily thresholds.
Optional destination blocklists, caller-id rewrites, an active time window, or the per-trunk CDR webhook contract.
Response
Created — the resource was created successfully.
The response is of type object.