Skip to main content
POST
Make Call

Authorizations

Authorization
string
required
Enter your ContactSwing JWT Bearer token.

Path Parameters

agent_id
string
required
ID of the AI agent to handle the call.

Request Body

phone_number
string
required
Phone number in E.164 format. Example: +1234567890
customer_name
string
Name of the person being called. Example: John Doe
call_purpose
string
Purpose or reason for the call. Example: Appointment confirmation

Response

200 OK - Call initiated successfully
ctx_id
string
Request context ID
data
object
call_id
string
Initiated call session ID
status
string
Call status
agent_id
string
Agent handling the call
message
string
“Request processed successfully”
400 Bad Request - Invalid request parameters 401 Unauthorized - Invalid or missing token 500 Internal Server Error - Server error

Example