CreateTelephonyCallJobRequest interface

A request to create one durable direct outbound call job.

Properties

connection_name

The Foundry connection name in the current project used to originate the call. Its category selects Twilio or Azure Communication Services / Teams Phone Extension. No inbound telephony binding is required.

destination

The phone destination to call.

purpose

An optional customer-declared purpose for placing the call.

retry_policy

The provider-attempt retry policy. Omit it for one attempt with no retry delay.

schedule

The optional execution window.

source

The caller identity used to originate the call. For a Twilio connection, provide an authorized E.164 phone number. For an Azure Communication Services / Teams Phone Extension connection, provide the Teams Resource Account object ID. The identity type is inferred from the connection category; originating does not change inbound routing.

structured_inputs

Structured input values available to the agent and greeting for this call. Agent-declared inputs are validated against their schemas; omitted optional inputs may use their Agent-defined default values, while omitted required inputs are rejected. Additional inputs remain available as dynamic template variables.

Property Details

connection_name

The Foundry connection name in the current project used to originate the call. Its category selects Twilio or Azure Communication Services / Teams Phone Extension. No inbound telephony binding is required.

connection_name: string

Property Value

string

destination

The phone destination to call.

destination: TelephonyOutboundDestination

Property Value

purpose

An optional customer-declared purpose for placing the call.

purpose?: string

Property Value

string

retry_policy

The provider-attempt retry policy. Omit it for one attempt with no retry delay.

retry_policy?: TelephonyOutboundRetryPolicyUnion

Property Value

schedule

The optional execution window.

schedule?: TelephonyCallJobSchedule

Property Value

source

The caller identity used to originate the call. For a Twilio connection, provide an authorized E.164 phone number. For an Azure Communication Services / Teams Phone Extension connection, provide the Teams Resource Account object ID. The identity type is inferred from the connection category; originating does not change inbound routing.

source: string

Property Value

string

structured_inputs

Structured input values available to the agent and greeting for this call. Agent-declared inputs are validated against their schemas; omitted optional inputs may use their Agent-defined default values, while omitted required inputs are rejected. Additional inputs remain available as dynamic template variables.

structured_inputs?: Record<string, any>

Property Value

Record<string, any>