> ## Documentation Index
> Fetch the complete documentation index at: https://docs.contactswing.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Call

> Create call API that supports both v1 and v2 versions.

### Authorizations

**Authorization** `string` *required*

Enter your ContactSwing JWT Bearer token.

### Request Body

**version** `string`

API version: `"v1"` (Twilio) | `"v2"` (LiveKit SIP). Default: `"v1"`

**phone\_number** `string` *required*

Phone number in E.164 format. Example: `+1234567890`

**agent\_id** `string` *required*

ID of the AI agent to handle the call

**customer\_name** `string`

Name of the person being called. Example: `John Doe`

**call\_purpose** `string`

Purpose or reason for the call. Example: `Appointment reminder`

### Response

**200 OK** - Call initiated successfully

**ctx\_id** `string`

Request context ID

**data** `object`

**call\_id** `string`

Call session ID

**status** `string`

Call status

**version** `string`

Used API version

**message** `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):**

```json theme={null}
{
  "version": "v1",
  "phone_number": "+1234567890",
  "agent_id": "agent_123",
  "customer_name": "John Doe"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.