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

# Authentication

> How to authenticate to the KolaVoice API.

# Authentication

The initial KolaVoice API uses account-level API keys.

## Create an API key

1. Sign in to KolaVoice.
2. Open the dashboard API page.
3. Create a key for outbound calling.
4. Copy the generated key immediately. It is shown only once.

## Send the API key

Use the `X-API-Key` header:

```http theme={null}
X-API-Key: kva_live_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxx
```

You can also send the same value as a bearer token if your client only supports `Authorization`:

```http theme={null}
Authorization: Bearer kva_live_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxx
```

## Notes

* The key belongs to one KolaVoice account.
* The account must have access to the `agent_id` you send.
* The account must have an active outbound-enabled number, or be allowed to use the system default outbound number.
* Outbound calls also enforce wallet and outbound capacity checks.

## Example

```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"
  }'
```