Alex
06/07/2026, 4:06 PMAI Evy
06/07/2026, 4:06 PMAI Evy
06/07/2026, 4:07 PM{{user_number}} is not the same for both from and to numbers. [(1) ]()
The {{user_number}} dynamic variable represents the user's phone number, which changes based on call direction:
- For **inbound calls**: {{user_number}} is the from_number
- For **outbound calls**: {{user_number}} is the to_number
There's also a separate {{agent_number}} variable that represents:
- For **inbound calls**: the to_number
- For **outbound calls**: the from_number
So {{user_number}} always refers to the end user's phone number, while {{agent_number}} always refers to the agent's phone number, regardless of call direction.AI Evy
06/07/2026, 4:07 PMAI Evy
06/07/2026, 4:07 PMAlex
06/07/2026, 4:20 PMAI Evy
06/07/2026, 4:20 PMAI Evy
06/07/2026, 4:21 PM{"customer_id":"cust_123"})
- `custom_sip_headers`: A JSON string of custom SIP headers, keys must start with X- (e.g., {"X-Custom-Header":"value"})
- `ignore e164 validation`: Set to true to bypass e.164 format validation (only applies when using custom telephony, not Retell Telephony)
For dynamic variables:
Add additional columns in the CSV with custom data for each recipient. For example, a column header first_name can be referenced as {{first_name}} in your prompts.
Any columns not listed above are treated as dynamic variables that get injected into your Response Engine prompt and tool descriptions.AI Evy
06/07/2026, 4:21 PMAI Evy
06/07/2026, 4:21 PMAlex
06/07/2026, 4:21 PMAlex
06/07/2026, 4:22 PMAI Evy
06/07/2026, 4:22 PMAI Evy
06/07/2026, 4:22 PMphone number - The phone number to call
Custom dynamic variable columns:
- customer_name or name - The recipient's name
Example CSV format:
phone number,customer_name
+12137774445,John Doe
+14157774444,Jane Smith
You can then reference these variables in your agent prompts using the {{variable_name}} syntax, like {{customer_name}}
When making outbound calls via API, you would pass these in the retell_llm_dynamic_variables field: [(2) ]()
{
"customer_name": "John Doe"
}
All values in retell_llm_dynamic_variables must be stringsAI Evy
06/07/2026, 4:22 PMAI Evy
06/07/2026, 4:22 PMAlex
06/07/2026, 4:27 PMAI Evy
06/07/2026, 4:27 PMAI Evy
06/07/2026, 4:28 PM{{variable_name}} syntax. [(1) ]()
For example, if your CSV column is named customer_name, you would add this to your prompt:
Hello {{customer_name}}, thanks for calling!
Or if you named the column `name`:
Hi {{name}}, how can I help you today?
The variable name in your prompt must match the column header in your CSV exactly. When the agent makes the call, {{customer_name}} will automatically be replaced with the actual name from that row in the CSV.
You can use dynamic variables in:
- **Prompts**: Agent instructions and personality
- **Begin message**: Opening greeting
- **Tool configurations**: Custom function URLs, tool descriptions, property descriptionsAI Evy
06/07/2026, 4:28 PMAI Evy
06/07/2026, 4:28 PM