OptionalfromOptionalfromNumber id to call from. Legacy alternative to fromNumber — provide exactly one.
OptionalidempotencyUnique key (e.g. a UUID) making the placement idempotent. Optional — pass the same key when retrying a failed or ambiguous makeCall and the server returns the already-placed call instead of dialing again.
OptionallanguageBCP-47 language tag, e.g. "en-US". Optional — when omitted, the server detects the language from the destination number's country prefix and the agent handles both it and en-US.
OptionalmaxMaximum duration for this call in seconds. Optional — when omitted the account-level or number-level cap applies (if any).
System prompt for the AI voice agent during this call.
OptionaltransferForward-to number in E.164 format. Optional — when set, the agent waits for
a real human (riding out hold music and IVR menus) and then cold-transfers
the call to this number. Must differ from to and the from number.
OptionalvoiceVoice gender for the agent on this call. Optional — when omitted, the voice is female (the default for every language). Pass "male" to override.
Number to call from, referenced flexibly: a phone-number id, one of your numbers in E.164, or a nickname. Provide exactly one of
fromNumberorfromNumberId(enforced by the server).