Sign in
SIP Addresses

Create SIP address

Creates a standalone SIP Address with a SIP URI, registration password, media and IP-authentication settings, and a resource that handles inbound calls. Use it when an external SIP device or system must register to or dial a dedicated URI. Use Create SIP credential for a device credential managed as a Fabric resource, or Create E911 address for a physical emergency-service location.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Calling, Fax, Messaging, or Video.

Learn more about API scopes.

post/api/fabric/sip_addresses

Request body

namestring required

URL-safe name for the SIP address — lowercase letters, numbers, and hyphens only (no spaces or other special characters). Must be unique within the project and is used to build the address's SIP URI.

userstring

SIP username used to reach this address (no spaces). Defaults to *, which accepts any username. Together with the address's Domain, must be unique across your SignalWire account.

context_idstring uuid

Universal Unique Identifier.

calling_handler_resource_idstring uuid required

Universal Unique Identifier.

ip_auth_enabledboolean

Whether to enforce IP authentication for this address.

ip_authstring[]

Whitelisted IP/CIDR entries. Required (at least one) when ip_auth_enabled is true. Maximum 256 entries.

codecsSipAddressCodec[]

Non-empty subset of enabled codecs.

ciphersCiphers[]

Non-empty subset of enabled SRTP ciphers.

encryption'required' | 'optional' | 'forbidden'
passwordstring

Write-only SIP registration password. Never returned in any response.

Example request

{
  "name": "sales-line",
  "user": "agent",
  "ip_auth_enabled": true,
  "ip_auth": [
    "10.0.0.0/24"
  ],
  "codecs": [
    "OPUS"
  ],
  "ciphers": [
    "AES_256_CM_HMAC_SHA1_80"
  ],
  "password": "sup3r-s3cret"
}

Response

The request has succeeded and a new resource has been created as a result.

idstring uuid required

Universal Unique Identifier.

type'sip_address' required

The object type. Always sip_address.

resource_idstring uuid required

Universal Unique Identifier.

namestring required

URL-safe name for the SIP address. Used to build its SIP URI.

display_namestring required

Human-friendly label for the SIP address. Defaults to name.

contextstring required

The Domain this address is grouped under — for example, public for your project's default Domain.

uristring required

Full SIP URI for this address.

userstring required

SIP username used to reach this address. * accepts any username.

encryption'required' | 'optional' | 'forbidden' required
codecsSipAddressCodec[] required

Enabled codecs for calls to this address.

ciphersCiphers[] required

Enabled SRTP ciphers for calls to this address.

ip_auth_enabledboolean required

Whether IP authentication is enforced for this address.

ip_authstring[] required

Whitelisted IP/CIDR entries used when ip_auth_enabled is true.

calling_handler_resource_idstring uuid required

Universal Unique Identifier.

created_atstring date-time required

Date and time when the SIP address was created.

updated_atstring date-time required

Date and time when the SIP address was last updated.

Example response

{
  "type": "sip_address",
  "name": "support-line",
  "display_name": "support-line",
  "context": "public",
  "uri": "sip:my-space-support-line@sip.signalwire.com",
  "user": "*",
  "codecs": [
    "PCMU",
    "PCMA"
  ],
  "ciphers": [
    "AEAD_AES_256_GCM_8",
    "AES_256_CM_HMAC_SHA1_80",
    "AES_CM_128_HMAC_SHA1_80",
    "AES_256_CM_HMAC_SHA1_32",
    "AES_CM_128_HMAC_SHA1_32"
  ],
  "ip_auth": [],
  "created_at": "2024-05-06T12:20:00Z",
  "updated_at": "2024-05-06T12:20:00Z"
}

Changes

Changed in 4 of the 138 revisions of this API.22

Of the 138 revisions, 3 have a changelog that could not be searched.