Skip to main content
POST
Create Call

Authorizations

string
required
Enter your ContactSwing JWT Bearer token.

Request Body

string
API version: "v1" (Twilio) | "v2" (LiveKit SIP). Default: "v1"
string
required
Phone number in E.164 format. Example: +1234567890
string
required
ID of the AI agent to handle the call
string
Name of the person being called. Example: John Doe
string
Purpose or reason for the call. Example: Appointment reminder

Response

200 OK - Call initiated successfully
string
Request context ID
object
string
Call session ID
string
Call status
string
Used API version
string
“Request processed successfully”
400 Bad Request - Invalid request parameters 401 Unauthorized - Invalid or missing token 429 Too Many Requests - Rate limit exceeded (10 calls per minute) 500 Internal Server Error - Server error

Examples

v1 Call (Twilio):