Initiate Outbound Call

POSThttps://api.trillet.ai/v1/api/call

Headers

x-workspace-idstringrequired

Workspace identifier for the API.

Request Body

tostringrequired

The phone number to which the call will be made.

call_agent_idstringrequired

The ID of the agent assigned to make the call.

callback_urlstring

A URL to receive webhook events about the call. If provided, this URL will be used for notifications.

dynamic_variablesobject

Dynamic variables that can be used to customize call scripts. Each key represents a variable that can be inserted into the call script dynamically. For example:

metadataobject

Any fields passed here will be sent to the call agent and directly passed to the webhook triggered by the agent under its 'metadata' header, but they will not be included in the call agent's context.

Response Fields

statusstring

The status of the request, indicating the success or failure of the call initiation.

messagestring

A message providing feedback about the call initiation process, typically confirming successful initiation or describing an error.

callIdstring

A unique identifier assigned to the initiated call. This ID can be used to track the call's progress or retrieve its details later.

roomNamestring

The name of the LiveKit room created for this call session.

jobIdstring

The identifier of the background job scheduled to execute the outbound call.

{
  "status": "success",
  "message": "Outbound call job scheduled for agent a1b2c3d4e5f6a7b8c9d0e1f2 to number +1234567890",
  "callId": "f9e8d7c6b5a4f3e2d1c0b9a8",
  "roomName": "a1b2c3d4e5f6a7b8c9d0e1f2-x7k2m9p4q1",
  "jobId": "123"
}