Skip to main content
POST
/
api
/
calls
/
create-phone-call
cURL
curl --request POST \
  --url http://localhost:8080/api/calls/create-phone-call \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-API-SECRET: <api-key>' \
  --data '
{
  "from_number": "+14157774444",
  "to_number": "+12137774445",
  "override_agent_id": "agent-123",
  "metadata": {
    "customer_id": "cust-001",
    "campaign": "summer-2024",
    "priority": "high"
  }
}
'
{
  "message": "<string>",
  "status": "<string>",
  "error": "<string>",
  "data": {}
}

Authorizations

X-API-KEY
string
header
required

API Key for MCP server and external service authentication

X-API-SECRET
string
header
required

API Secret for MCP server and external service authentication

Body

application/json

Phone call creation request body

from_number
string
required

Source phone number for outbound call

to_number
string
required

Destination phone number to call

override_agent_id
string

Specific agent ID to use; auto-select if omitted

scheduled_timestamp
integer

Unix timestamp (seconds) for scheduled call execution

metadata
object

Additional metadata for the call

Response

OK

message
string
status
string
error
string
data
object