Initiate an outbound call by POST to '/v2/create-phone-call'. Requires 'from_number' and 'to_number' in E.164 format. Optional overrides and metadata supported. On success, returns call details including type, status, and IDs.
metadataobjectAn arbitrary object for storage purpose only. You can put anything here like your internal customer id associated with this call. Not used for processing. Stored for retrieval later.
to_numberRequiredstringThe number you want to call, in E.164 format. Right now only US numbers are officially supported when using Retell-purchased numbers.
from_numberRequiredstringThe number you own in E.164 format. Must be a number purchased from Retell or imported to Retell.
override_agent_idstringFor this particular call, override the agent used with this agent id. This does not bind the agent to this number, this is for one time override.
ignore_e164_validationbooleanIf true, E.164 validation will be ignored for the from_number. Useful for dialing internal pseudo numbers. Only applies with custom telephony, not Retell Telephony.
override_agent_versionintegerFor this particular call, set the agent version. Only effective when override_agent_id is set.
retell_llm_dynamic_variablesobjectA set of key-value pairs to inject into the prompt and tool descriptions. Values must be strings. Use {{variable_name}} in prompts to reference them.
dataRequiredData from the action execution
errorstringError if any occurred during the execution of the action
successfulRequiredbooleanWhether or not the action execution was successful or not
API key connection. Risk level 2 of 5.
Free Action
No published Skills explicitly reference this Action yet.