Authentication

The initial KolaVoice API uses account-level API keys.

Create an API key

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

Send the API key

Use the X-API-Key header:

X-API-Key: kva_live_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxx

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

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

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

⌘I