Skip to main content
POST
/
calls
import os
from sarj_platform_sdk import SDK

sdk = SDK(api_key_auth=os.environ["SARJ_API_KEY"])
res = sdk.calls.create_call(
    phone_number="+966512345678",
    scenario_id="scn_abc123",
    language="ar",
)
print(f"Call queued: {res.data.id}")
{
  "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

Authorization
string
header
required

API key from your Sarj.ai dashboard. Pass as: Authorization: Bearer

Body

application/json
phone_number
string
required

Phone number to call in E.164 format.

Example:

"+966512345678"

scenario_id
string
required

ID of the scenario to use for this call.

variables
Variables · object

Template variables to inject into the scenario.

language
enum<string>
default:ar

Language for the call. Defaults to Arabic (ar) if not specified.

Available options:
en,
ar,
ur

Response

Successful Response

data
PublicCall · object
required
meta
ResponseMeta · object

Contains request-level metadata included with every public API response.

Last modified on June 11, 2026