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

# Create outbound call

> Launch an outbound AI phone call.

# Create outbound call

Launches an outbound AI phone call immediately.

## Example request

```bash theme={null}
curl -X POST "https://cloud.kolavoice.com/api/v1/outbound/calls" \
  -H "X-API-Key: kva_live_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to_number": "+256782435630",
    "agent_id": "836ca07f-98ad-47ec-bfc6-afd457fa2b16",
    "from_number": "+256323200643"
  }'
```

## Example response

```json theme={null}
{
  "call_id": "ec40a1f1-0b15-408b-a6f4-79314c0b89f9",
  "room_name": "call-836ca07f-1783580857-94e4c116",
  "status": "dialing",
  "to_number": "+256782435630",
  "agent": "General Outbound Agent"
}
```

## Common errors

| Status | Meaning                                                                    |
| ------ | -------------------------------------------------------------------------- |
| `400`  | Invalid `from_number`, missing outbound-enabled number, or invalid request |
| `401`  | Invalid or missing API key                                                 |
| `402`  | Wallet balance is too low to start the call                                |
| `404`  | Agent not found                                                            |
| `503`  | Calling is under maintenance                                               |