weronika
03/06/2026, 2:03 PMAI Evy
03/06/2026, 2:03 PMAI Evy
03/06/2026, 2:03 PMAI Evy
03/06/2026, 2:03 PM{{variable_name}} syntax.
Where you can use dynamic variables:
- Prompts (agent instructions and personality)
- Begin message (opening greeting)
- Tool configurations (custom function URLs, tool descriptions, property descriptions)
- Call handling (voicemail prompts, transfer call phone numbers, warm transfer instructions)
- Webhook URLs
Example usage in a prompt:
"Hello {{user_name}}, I understand you're interested in {{product_name}}. How can I help you today?"
For outbound calls, set your variables in the retell_llm_dynamic_variables field when using the Create Phone Call API:
json
{
"user_name": "John Smith",
"product_name": "Premium Plan",
"account_status": "active"
}
For inbound calls, you can supply dynamic variables via the Inbound Call Webhook.
You can also set default values for dynamic variables at the agent level, which serve as fallbacks when specific variables aren't provided in the call request.AI Evy
03/06/2026, 2:03 PM