Skip to main content
POST
/
calls
Create Call
curl --request POST \
  --url https://api.dev.kathan.tech/calls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number_id": "<string>",
  "to_number": "<string>",
  "assistant_id": "<string>",
  "label": "<string>"
}
'
{
  "id": "<string>",
  "to_number": "<string>",
  "provider": "<string>",
  "status": "<string>",
  "phone_number_id": "<string>",
  "assistant_id": "<string>",
  "from_number": "<string>",
  "provider_call_sid": "<string>",
  "direction": "<string>",
  "created_at": "<string>",
  "duration_seconds": 123,
  "timestamp": "<string>",
  "summary": "<string>",
  "greeting_one_liner": "<string>",
  "user_messages": 123,
  "agent_messages": 123
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
phone_number_id
string
required

The phone_number_id to place the call from

to_number
string
required

Destination number in E.164 format

assistant_id
string | null

Optional: force an assistant for this call

label
string | null

Optional label for tracking

Response

Successful Response

id
string
required
to_number
string
required
provider
string
required
status
string
required
phone_number_id
string | null
assistant_id
string | null
from_number
string | null
provider_call_sid
string | null
direction
string | null
created_at
string | null
duration_seconds
integer | null
timestamp
string | null
summary
string | null
greeting_one_liner
string | null
user_messages
integer | null
agent_messages
integer | null