Skip to main content

Overview

The sip:request verb sends a SIP INFO, NOTIFY, or MESSAGE request during a call.

Example

{
  "verb": "sip:request",
  "method": "INFO",
  "headers": {
    "X-Metadata": "my sip metadata"
  },
  "actionHook": "/info"
}

Parameters

ParameterTypeRequiredDescription
methodstringYesSIP method, should be one of INFO, MESSAGE, or NOTIFY.
actionHookstringNoA webhook to call when the SIP request has completed.
bodystringNoThe body of the SIP request, if any.
headersobjectNoAn object containing headers (key-value pairs) to include with the SIP request.
The sip:request verb completes when a response is received from the far end.

actionHook properties

The actionHook provides the status code of the sip response:
  • result: ‘success’ or ‘failed’
  • sipStatus: sip status code of response
  • err: error message, in the case of failure