Skip to main content
The click-to-call API lets you initiate phone calls from your application. Astradial calls the “from” party first, and when they answer, connects them to the “to” party.

​
Endpoint

POST /api/v1/calls/click-to-call

​
Authentication

Requires an API key with calls.click_to_call permission. 
X-API-Key: ak_your_api_key

​
Request body

{
  "from": "1001",
  "to": "9944421125",
  "to_type": "external",
  "caller_id": "+918065978015",
  "timeout": 30,
  "variables": {
    "custom_key": "custom_value"
  }
}
FieldTypeRequiredDescription
fromstringYesExtension number or phone number to call first
tostringYesDestination to connect after “from” answers
to_typestringNoType of destination: extension, queue, ivr, ai_agent, or external
caller_idstringNoPhone number shown as caller ID to the “to” party
timeoutnumberNoSeconds to wait for “from” to answer (default: 30)
variablesobjectNoCustom variables passed to the call

​
Example: agent calls a customer

curl -X POST https://your-server:8000/api/v1/calls/click-to-call \
  -H "X-API-Key: ak_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "1001",
    "to": "9944421125",
    "to_type": "external",
    "caller_id": "+918065978015"
  }'

​
Example: connect two extensions

curl -X POST https://your-server:8000/api/v1/calls/click-to-call \
  -H "X-API-Key: ak_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "1001",
    "to": "1002",
    "to_type": "extension"
  }'

​
How it works

  1. Astradial calls the from number/extension
  2. When they answer, Astradial calls the to number/extension
  3. When both answer, they are connected in a call
  4. Either party can hang up to end the call

​
Response

{
  "status": "success",
  "message": "Call initiated"
}
If the call fails: 
{
  "status": "error",
  "message": "Failed to originate call: extension not registered"
}