Create Subscriber SIP Endpoint
POST/resources/subscribers/:fabric_subscriber_id/sip_endpoints
Creates a Subscriber Sip Endpoint
Request
Path Parameters
Unique ID of a Fabric Subscriber.
- application/json
Body
required
- Create Subscriber SIP Endpoint with Call Handler
- Create Subscriber SIP Endpoint with Resource ID
oneOf
Call handler of the Sip Endpoint.
Possible values: [default
, passthrough
, block-pstn
]
Username of the Sip Endpoint.
justice-league
Password of the Sip Endpoint.
hack-me-if-you-can
Confirmation of the Password
hack-me-if-you-can
Caller ID of the Sip Endpoint.
call-id-123
The Number to send as.
+14632322867
Ciphers of the Sip Endpoint.
Possible values: [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
]
Codecs of the Sip Endpoint.
Possible values: [OPUS
, G722
, PCMU
, PCMA
, G729
, VP8
, H264
]
Encryption requirement of the Sip Endpoint.
Possible values: [default
, required
, optional
]
default
optional
Universal Unique Identifier.
Username of the Sip Endpoint.
justice-league
Password of the Sip Endpoint.
hack-me-if-you-can
Confirmation of the Password
hack-me-if-you-can
Caller ID of the Sip Endpoint.
call-id-123
The Number to send as.
+14632322867
Ciphers of the Sip Endpoint.
Possible values: [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
]
Codecs of the Sip Endpoint.
Possible values: [OPUS
, G722
, PCMU
, PCMA
, G729
, VP8
, H264
]
Encryption requirement of the Sip Endpoint.
Possible values: [default
, required
, optional
]
default
optional
Responses
- 201
- 401
- 404
- 422
The request has succeeded and a new resource has been created as a result.
- application/json
- Schema
- Example (from schema)
Schema
Universal Unique Identifier.
Username of the Sip Endpoint.
justice-league
Caller ID of the Sip Endpoint.
call-id-123
Purchased or verified number
+14632322867
Ciphers of the Sip Endpoint.
Possible values: [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
]
Codecs of the Sip Endpoint.
Possible values: [OPUS
, G722
, PCMU
, PCMA
, G729
, VP8
, H264
]
Encryption
Possible values: [default
, required
, optional
]
Call handler of the Sip Endpoint.
Possible values: [default
, passthrough
, block-pstn
, relay_script
, laml_webhook
, laml_application
, dialogflow
, relay_context
, relay_connector
, video_room
, ai_agent
, call_flow
]
Universal Unique Identifier.
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"username": "justice-league",
"caller_id": "call-id-123",
"send_as": "+14632322867",
"ciphers": [
"AEAD_AES_256_GCM_8"
],
"codecs": [
"OPUS"
],
"encryption": "default",
"call_handler": "default",
"calling_handler_resource_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Access is unauthorized.
- application/json
- Schema
Schema
string
Possible values: [Unauthorized
]
The server cannot find the requested resource.
- application/json
- Schema
Schema
string
Possible values: [Not Found
]
Client error
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
errors
object[]
required
Error type.
Error code.
Error details.
Request parameter associated with this error.
Link to developer resource for this error.
{
"errors": [
{
"type": "validation_error",
"code": "invalid_parameter",
"message": "Ciphers are invalid",
"attribute": "ciphers",
"url": "https://developer.signalwire.com/rest/signalwire-rest/overview/error-codes#invalid_parameter"
}
]
}