Custom SIP headers are used heavily in telephony SIP world to pass information around. It’s only available for phone calls. Right now we support receiving SIP headers for inbound calls, sending SIP headers for outbound calls and when initiating transfers.
Parse custom SIP headers for inbound calls
For inbound calls, the custom SIP headers (headers that starts withX-
or x-
) are automatically received, extracted and available in the call.custom_sip_headers
, it’s also automatically added to your collection of dynamic variables, and you can access it within your agent by stripping the X-
or x-
prefix. There’s no configuration needed for this feature.
For example, if this is the SIP header received for an inbound call:
call.custom_sip_headers
field, and they will be added to your dynamic variables.
Set custom SIP headers for outbound calls

X-
.
Set custom SIP headers for call transfers
For call transfers, you can also add custom SIP headers as needed. It must starts withX-
.
You can use dynamic variable for your custom SIP header value, so you can pass information extracted from the call to the receiving party.
For cold transfer with transferee number, it will use SIP REFER to transfer the call. Different telephony providers may or may NOT honor the custom SIP headers in the REFER request. Twilio for example, does not honor the custom SIP headers in the REFER request, so the sip headers you set in transfer call tool will not work for cold transfer with transferee number when using Twilio.
- Conversation flow agents, check out call transfer node for more details.
- Single / multi agent, check out call transfer function for more details.