gharpe2
03/11/2026, 2:53 PMAI Evy
03/11/2026, 2:53 PMAI Evy
03/11/2026, 2:53 PM{{user_number}} via prompting. {{user_number}} is a system default variable that automatically contains the user's phone number (from_number for inbound calls, to_number for outbound calls) [(1) ]() . System variables are automatically provided by Retell and cannot be modified through prompts .
However, you can create a custom dynamic variable to store the caller's preferred number. You would:
1. Use the Extract Dynamic Variable function during the conversation to capture the number the caller reads out
2. Store this in a custom variable like {{preferred_number}}
3. Use {{preferred_number}} in your transfer call phone number field instead of {{user_number}}
Dynamic variables can be used in transfer call phone numbers , and you can dynamically define phone numbers for call transfers [(2) ]() . Just ensure you use the double curly brace syntax {{variable_name}} [(3) ]() .AI Evy
03/11/2026, 2:53 PMAI Evy
03/11/2026, 2:53 PMgharpe2
03/11/2026, 3:09 PMAI Evy
03/11/2026, 3:09 PMAI Evy
03/11/2026, 3:10 PM{{preferred_number}} variable as a custom SIP header key/value pair [(1) ]() . Custom SIP headers are used to pass information in telephony SIP scenarios and are available for phone calls .
When configuring call transfers, you can add custom SIP headers as needed, and these headers must start with X- . You can use dynamic variables for your custom SIP header values, allowing you to pass information extracted from the call to the receiving party .
For example, you could create a custom SIP header like:
- **Header name**: X-Preferred-Number
- **Header value**: {{preferred_number}}
The custom SIP headers you set will be included in the transfer request . However, there's an important limitation: for cold transfer with transferee number using SIP REFER, different telephony providers may or may not honor the custom SIP headers in the REFER request . Specifically, Twilio does not honor custom SIP headers in the REFER request, so the SIP headers you set in the transfer call tool will not work for cold transfer with transferee number when using Twilio .
The displayed Caller ID field you're seeing is separate from custom SIP headers and is limited to the predefined options (Retell Agent's Number or User's Number) . To pass your custom preferred number, custom SIP headers are the correct approach .
**AI Evy
03/11/2026, 3:10 PMAI Evy
03/11/2026, 3:10 PMAI Evy
03/11/2026, 3:54 PMgharpe2
03/11/2026, 5:28 PMAI Evy
03/11/2026, 5:28 PMAI Evy
03/11/2026, 5:28 PMX-AI-Tenant: {{tenant}}, the header appeared in the SIP INVITE as X-AI-Tenant: {{tenant}} (literal text) rather than the actual variable value .
2. **Headers not saving in Multi-Prompt Agents**: There's a documented issue where custom SIP headers don't save when configured in the call_transfer function on Multi-Prompt Agents [(2) ]() . Users reported that after adding custom SIP headers, the next time they entered the function, the Custom SIP Headers part was empty, and logs showed custom sip headers undefined .
3. **Telephony provider compatibility**: For cold transfer with transferee number using SIP REFER, different telephony providers may or may not honor the custom SIP headers in the REFER request [(3) ]() . Twilio specifically does not honor custom SIP headers in the REFER request, so the SIP headers you set in the transfer call tool will not work for cold transfer with transferee number when using Twilio .
What to check:
- Verify your telephony provider supports custom SIP headers in SIP REFER requests [(3) ]() [(4) ]()
- Confirm whether you're using a Multi-Prompt Agent (known issue) [(2) ](AI Evy
03/11/2026, 5:28 PM{{confirmed_caller_number}} is being properly collected before the transfer occurs [(5) ]()
Based on the community reports, this appears to be a combination of both provider limitations and potential Retell platform issues with dynamic variable substitution in custom SIP headers during transfers [(1) ]() [(2) ]() .AI Evy
03/11/2026, 5:28 PMAI Evy
03/11/2026, 5:28 PMgharpe2
03/11/2026, 5:48 PMAI Evy
03/11/2026, 5:48 PMAI Evy
03/11/2026, 5:48 PMcustom sip headers undefined .
**Important troubleshooting step**: Agent versioning is important for configuration changes [(1) ]() [(2) ]() . Make sure you're checking the correct agent version after making changes.
To report this issue to Retell:
Visit [Documentation]() or contact support through the appropriate channels.
When reporting, include:
- Your agent type (Conversation Flow or Multi-Prompt)
- The specific custom SIP header configuration you're trying to save (e.g., X-Confirmed-Caller-Number: {{confirmed_caller_number}})
- Whether this is happening with cold or warm transfers [(3) ]() [(4) ]() [(5) ]()
- Your agent version number
- Any error messages from call logs
This will help Retell's team investigate whether this is the same issue reported by other users or a new variation.AI Evy
03/11/2026, 5:49 PMAI Evy
03/11/2026, 5:49 PM