Skip to main content

<Header>

TL;DR

Add a SIP <Header> to an outbound <Dial> request.

Need Help? Let's Talk

Join our Discord community - we're here to help.

Description

Add custom SIP headers to the <DIAL> operation.

Example

 <?xml version="1.0" encoding="UTF-8"?>
<Dial>
<Header name="X-AuthToken" value="abcdef"/>
<Header name="X-SignedCaller" value="9012345678"/>
<Sip>sip:1234@example.com</Sip>
</Dial>

Attributes

The following attributes are supported:

Attribute NameAllowed ValuesDefault Value
nameStringNone
valueStringNone

When adding <Header> nouns inside the <Dial> verb, any specified valid header will be added as a custom SIP header to the outgoing dial - when dialing registered subscribers, through configured trunks, or using direct SIP dial (this type of custom headers is not supported for Registration-Free subscribers). A valid header must have a name that starts with X-.