Skip to main content
POST
Trigger Call

Request Body

string
required
Phone number in E.164 format (e.g., +14155551234). Must start with + followed by country code and number.
string
required
Contact’s display name. Maximum 128 characters.
string
required
The ID of the agent that will handle this call. Must reference an existing agent in your account.
object
Optional key-value pairs injected into the agent’s prompt. Maximum 20 entries. Keys max 64 characters, values max 512 characters.Example: {"company": "Acme Corp", "plan": "Enterprise"}
object
Optional retry configuration for failed call attempts.

Response

boolean
Indicates if the call was triggered successfully.
object

Error Codes

This endpoint accepts both API Token (okt_...) and JWT authentication.