> ## 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.

# Make Call

> Initiate an outbound voice call using the specified AI agent.

### Authorizations

<ParamField header="Authorization" type="string" required>
  Enter your ContactSwing JWT Bearer token.
</ParamField>

### Path Parameters

<ParamField body="agent_id" type="string" required>
  ID of the AI agent to handle the call.
</ParamField>

### Request Body

<ParamField path="phone_number" type="string" required>
  Phone number in E.164 format. Example: `+1234567890`
</ParamField>

<ParamField path="customer_name" type="string">
  Name of the person being called. Example: `John Doe`
</ParamField>

<ParamField path="call_purpose" type="string">
  Purpose or reason for the call. Example: `Appointment confirmation`
</ParamField>

### Response

**200 OK** - Call initiated successfully

<ResponseField name="ctx_id" type="string">
  Request context ID
</ResponseField>

<ResponseField name="data" type="object">
  <ResponseField name="call_id" type="string">Initiated call session ID</ResponseField>
  <ResponseField name="status" type="string">Call status</ResponseField>
  <ResponseField name="agent_id" type="string">Agent handling the call</ResponseField>
</ResponseField>

<ResponseField name="message" type="string">
  "Request processed successfully"
</ResponseField>

**400 Bad Request** - Invalid request parameters

**401 Unauthorized** - Invalid or missing token

**500 Internal Server Error** - Server error

### Example

```json theme={null}
{
  "phone_number": "+1234567890",
  "customer_name": "John Doe", 
  "call_purpose": "Follow-up appointment"
}
```