Sahal Duri
01/16/2026, 11:33 AMAI Evy
01/16/2026, 11:33 AMAI Evy
01/16/2026, 11:34 AMretell_llm_dynamic_variables field: [(1) ]()
json
{
"user_name": "John Smith",
"product_name": "Premium Plan",
"account_status": "active"
}
All values must be strings.
## For Inbound Calls
You can supply dynamic variables via the Inbound Call Webhook.
## Using the SDK
Here's an example using the Retell SDK: [(2) ]()
javascript
const phoneCallResponse = await client.call.createPhoneCall({
from_number: '+14157774444',
to_number: '+12137774445',
}) ;
With dynamic variables included:
json
{
"from_number": "+16504144521",
"to_number": "your_target_number",
"override_agent_id": "agent_71724df7636716ceb3a7e244c8",
"retell_llm_dynamic_variables": {
"name": "Sarah"
}
}
## Default Variables
You can also set default values for dynamic variables at the agent level in the dashboard, which serve as fallbacks when specific variables aren't included in the call request. [(1) ]()
## In Prompts
Reference your variables using the {{variable_name}} syntax:
"Hello {{user_name}}, I understand you're interested in {{product_name}}. How can I help you today?"AI Evy
01/16/2026, 11:34 AMAI Evy
01/16/2026, 11:34 AMSahal Duri
01/16/2026, 11:46 AMAI Evy
01/16/2026, 11:46 AMAI Evy
01/16/2026, 11:46 AMAI Evy
01/16/2026, 11:46 AMAI Evy
01/16/2026, 11:46 AMAI Evy
01/16/2026, 11:46 AM