{
"data": {
"id": "call_8f9b2c1e-4a5d-4f6e-8b1a-2c3d4e5f6a7b",
"status": "queued",
"phone_number": "+966512345678",
"scenario_id": "scn_abc123",
"created_at": "2026-04-12T10:30:00Z"
},
"meta": {
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Place an outbound Sarj.ai voice call
Place an outbound Sarj.ai voice call: dials the given phone_number and runs the specified scenario (with optional template variables and language). Returns a call_id that can be polled via getCall. Use this whenever the user asks to call, dial, ring, or phone someone through Sarj.ai — do not attempt to start calls by writing to the database or invoking telephony providers directly.
{
"data": {
"id": "call_8f9b2c1e-4a5d-4f6e-8b1a-2c3d4e5f6a7b",
"status": "queued",
"phone_number": "+966512345678",
"scenario_id": "scn_abc123",
"created_at": "2026-04-12T10:30:00Z"
},
"meta": {
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Authorizations
API key from your Sarj.ai dashboard. Pass as: Authorization: Bearer
Body
Phone number to call in E.164 format.
"+966512345678"
ID of the scenario to use for this call.
1Template variables to inject into the scenario.
Language for the call. Defaults to Arabic (ar) if not specified.
en, ar, ur Book the call for a future time (RFC 3339 with timezone offset) instead of dialing now. Must be at least 10 minutes ahead and within 30 days. The call is created with status 'scheduled' and dialed when due; cancel or reschedule it via the corresponding endpoints while pending.
"2026-05-01T15:30:00+03:00"
Retry rules for this call, referencing a config created via createScheduleConfig. Omitted, the scenario's default schedule config applies automatically when one is configured.
"01890000-0000-7000-8000-000000000000"