Outbound Calls

Initiate outbound calls

Initiate outbound call

post

Initiates an outbound call via the telephony provider. The from_number must be owned by the organization and have outbound enabled.

Authorizations

BearerAuth

AuthorizationstringRequired

API key in format kros_live_xxxx for production or kros_test_xxxx for testing. Also accepts JWT tokens from Supabase Auth for dashboard sessions.

Header parameters

x-organization-idstring · uuidOptional

Organization UUID for multi-tenant context. Falls back to user's first organization if not provided.

Body

application/json

from_numberstringRequired

E.164 formatted phone number owned by org

Example: [phone]

to_numberstringRequired

E.164 formatted destination number

Example: [phone]

endpoint_idstring · uuidOptional

Optional endpoint to connect after answer

Responses

200

Call initiated

application/json

400

Bad request - Invalid parameters or request body

application/json

401

Unauthorized - Invalid or missing API key

application/json

402

Insufficient balance

application/json

403

Outbound not enabled for this number

application/json

post

/outbound-calls

HTTPcURLJavaScriptPython

POST /v1/outbound-calls HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 175

{
  "from_number": "[phone]",
  "to_number": "[phone]",
  "endpoint_id": "660e8400-e29b-41d4-a716-446655440001",
  "metadata": {
    "customer_id": "cust_12345",
    "campaign": "outreach_q1"
  }
}

{
  "status": "initiated",
  "provider": "freeswitch",
  "call_id": "880e8400-e29b-41d4-a716-446655440003",
  "from_number": "[phone]",
  "to_number": "[phone]",
  "message": "Call initiated successfully"
}