Skip to main content
POST
https://prod-contactswing-fastapi-962560522883.us-central1.run.app
/
v2
/
_voicecalls
/
{agent_id}
/
makeCall
Make Call
curl --request POST \
  --url https://prod-contactswing-fastapi-962560522883.us-central1.run.app/v2/_voicecalls/{agent_id}/makeCall \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "<string>"
}
'
{
  "ctx_id": "<string>",
  "data": {
    "call_id": "<string>",
    "status": "<string>",
    "agent_id": "<string>"
  },
  "message": "<string>"
}

​
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

{
  "phone_number": "+1234567890",
  "customer_name": "John Doe", 
  "call_purpose": "Follow-up appointment"
}