Webhooks

Client Registration

This webhook is sent when a SIP client tries to register, it is configured at the account level

Headers

AuthorizationstringRequired

Basic authentication of the form Basic <username:password>.

Request

provides details of the authentication request. The receiving server is responsible for authenticating the request as per RFC 2617

methodstringRequired
sip request method
realmstringRequired
sip realm
usernamestringRequired
sip username provided
expiresdoubleRequired
expiration requested, in seconds
noncestringRequired
nonce value
uristringRequiredformat: "uri"
sip uri in request
responsestringRequired
digest value calculated by the client
schemestringOptional
encryption protocol
algorithmstringOptional
encryption algorithm used, default to MD5 if not provided
qopstringOptional
qop value
cnoncestringOptional
cnonce value
ncstringOptional
nc value

Response

Your callback should return this HTTP status code in all cases. if the request was authenticated and you wish to admit the client to the network, this is indicated by setting the 'status' attribute in the body to 'ok'
statusenum
indicates whether the request was successfully authenticated
Allowed values:
messagestring or null

a human-readable message

call_hookstring or nullformat: "url"
url of application to invoke when this device places a call
expiresdouble or null
The expires value to grant to the requesting user. If not provided, the expires value in the request is observed. If provided, must be less than the requested expires value.
blacklistdouble or null

If provided, represents a period in seconds during which the source IP address should be blacklisted by the platform (0 means forever).