Alonso Breña
02/16/2026, 10:23 PMAI Evy
02/16/2026, 10:23 PMAI Evy
02/16/2026, 10:23 PM{{variable_name}} syntax in your prompts, begin message, or tool configurations.
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 use an inbound webhook to return dynamic variables. The structure should nest variables under `call_inbound`: [(2) ]()
json
{
"call_inbound": {
"dynamic_variables": {
"first_name": "Pranam",
"last_name": "Lipinski",
"email": "pranam@eocworks.com"
}
}
}
You can also set default values for dynamic variables at the agent level, which serve as a fallback when specific variables aren't included in the call request. [(1) ]()
If you want to test how your agent handles these variables before going live, you can use the LLM Playground to test dynamic variables and verify they're properly interpolated. [(3) ]()AI Evy
02/16/2026, 10:23 PMAI Evy
02/16/2026, 10:23 PM