Create a SIP trunk
const url = 'https://api.caller9.app/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/trunks';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"name":"example","default_cid_number_guid":"example","cid_display_name":"example","channel_limit":1,"localization":"US"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.caller9.app/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/trunks \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "example", "default_cid_number_guid": "example", "cid_display_name": "example", "channel_limit": 1, "localization": "US" }'Provisions a new SIP trunk with generated registration credentials for your PBX. Calls the PBX places through the trunk go out to the PSTN and are billed as trunk minutes; numbers can be routed to the trunk for inbound calls. Requires a paid plan in good billing standing; the Basic plan allows one trunk with at most 5 channels (409 plan_limit with limit trunks, billing or trunk_channels). Requires a full-access key.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Organization ID (UUID). Must be the organization that owns the API key.
Request Bodyrequired
Section titled “Request Bodyrequired”object
ID of one of the organization’s numbers to use as the default outbound caller ID.
Outbound caller ID name (CNAM). Uppercased, stripped to letters, digits, ., , and spaces, must start with a letter, and truncated to 15 characters; must end up at least 2 characters (empty is allowed). Defaults to the normalized trunk name.
Maximum concurrent calls. null means unlimited (not allowed on Basic). Basic is capped at 5 and defaults to 5; other plans default to unlimited.
ISO 3166-1 alpha-2 country code used to interpret numbers the PBX dials in national format.
Responses
Section titled “Responses”The created trunk, including its SIP credentials.
object
A SIP trunk your PBX registers to. Includes registration credentials — sip_password is a secret; store it securely and never log it.
object
SIP registration username.
SIP registration password (secret). Changes when rotated.
The trunk’s SIP URI (sip:<username>@sip.telnyx.com).
ID of the organization number used as the default outbound caller ID.
Outbound caller ID name (CNAM); empty if unset.
Maximum concurrent calls; null = unlimited.
ISO 3166-1 alpha-2 country code (default US).
Numbers routed to this trunk for inbound calls, sorted by number.
object
E.164 phone number.
Example generated
{ "trunk": { "guid": "example", "organization_guid": "example", "name": "example", "sip_username": "example", "sip_password": "example", "sip_uri": "example", "default_cid_number_guid": "example", "cid_display_name": "example", "channel_limit": 1, "localization": "example", "numbers": [ { "guid": "example", "number": "example", "name": "example" } ], "created_at": "2026-04-15T12:00:00Z", "updated_at": "2026-04-15T12:00:00Z" }}The request was invalid.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Missing, invalid, expired or revoked API key.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}The key isn’t allowed to do this (e.g. a read-only key making a change).
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Not found, or belongs to another organization.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Blocked by the organization’s plan.
object
Which cap was hit, e.g. studios, numbers, ai_screening, trunk_channels.
Example
{ "error": "plan_limit"}Too many requests for this API key. Retry after Retry-After seconds.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Headers
Section titled “Headers”Seconds until the rate-limit window resets.