Skip to main content
POST
Create SIP Trunk

Authorizations

x-api-key
string
header
required

API key for authentication. Generate API keys from the RevRing dashboard. A key is either full access or read-only; a read-only key is refused with 403 read_only_key on any request that creates, changes or deletes.

Body

application/json

Create a new SIP Trunk. Provide the proxy address and phone numbers.

proxy
string
required

Carrier host the SIP INVITE is sent to (required): a hostname or IPv4 address with an optional :port, for example my-trunk.pstn.twilio.com. No URL scheme or sip: prefix. The host must resolve in DNS; a typo is refused with 400 sip_trunk_proxy_unresolvable instead of creating a trunk that can never place a call

Example:

"my-trunk.pstn.twilio.com"

cloud
object
required

Phone numbers to associate with this trunk

friendlyName
string

Human-readable name for this trunk

Maximum string length: 128
username
string

SIP authentication username (optional)

password
string

SIP authentication password (not returned in responses)

Response

SIP trunk created

data
object

SIP Trunk for routing phone calls