CreateRetellCallRequest

toNumberstringrequired

Destination: E.164, 10/11-digit US, PBX extension, queue name, or SIP URI.

Possible values: non-empty and <= 512 characters

overrideAgentIdstring

Retell agent to use instead of the number's default outbound agent.

overrideAgentVersioninteger | string

Optional agent version override.

retellLlmDynamicVariables object

String values injected into the agent prompt.

property name*string

customSipHeaders object

X-* SIP headers to include; platform correlation headers are added automatically.

property name*string

tags object[]

Any Retell create-phone-call override as a dotted-path tag.

Possible values: <= 100

Array [

keystringrequired

Dotted path into the Retell create-phone-call payload (for example agent_override.agent.voice_id).

valuestringrequired

Raw value or JSON text parsed as booleans, numbers, arrays, or objects.

]

originalCallerIdstring

Original caller ID carried in X-Original_Caller_ID.

fromUserstring

From-user override carried in X-sipsandwich_from_user.

CreateRetellCallRequest

{
  "toNumber": "string",
  "overrideAgentId": "string",
  "overrideAgentVersion": 0,
  "retellLlmDynamicVariables": {},
  "customSipHeaders": {},
  "tags": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "originalCallerId": "string",
  "fromUser": "string"
}