Skip to main content
This page walks you from “I just signed up” to “I’ve called the API.” About two minutes start to finish.

​
1. Mint an API key

1

Open Settings → API Keys

Sign in at hub.kataven.ai, then go to hub.kataven.ai/settings and click the API Keys tab at the top.
2

Create a key

Click Create API key. Give it a name (e.g. local-dev, ci-deploy, claude-code) and pick an expiry — Never, 1 year, 90 days, or 30 days. Click Create.
3

Copy the token

The sk_live_… value appears once. Copy it now — we don’t store the plaintext, only an HMAC. If you lose it, mint another.
Your token looks like sk_live_acme_AbCd1234.... The middle segment (acme) is your account slug — the API resolves your tenant from the prefix, so you don’t need an X-Account-ID header anywhere.

​
2. Install the SDK

pip install kataven

​
3. Set the env var

export KATAVEN_API_KEY="sk_live_acme_AbCd1234..."
(Both SDKs read KATAVEN_API_KEY automatically. The Node SDK also reads KATAVEN_BASE_URL if you want to point at a non-prod instance.)

​
4. List your agents

from kataven import KatavenClient

client = KatavenClient()                 # picks up KATAVEN_API_KEY
for agent in client.agents.list():
    print(agent["id"], agent["name"])
A fresh account has zero agents — empty list is expected. Onto creating one.

​
5. Create your first agent

agent = client.agents.create(
    name="Front Desk",
    description="Greets callers and books appointments.",
    system_prompt="You are a friendly receptionist for Acme Co.",
    greeting_message="Thanks for calling Acme. How can I help?",
    llm_model="gpt-4o",
    voice_provider="cartesia",
    voice_id="a0e99841-438c-4a64-b679-ae501e7d6091",
)
print("Created:", agent["id"])

​
Verify in the dashboard

Open hub.kataven.ai/agents. Your new agent shows up at the top of the list. Click it to see config, attach playbooks/FAQs, or test it in the playground.

​
What’s next

Your first agent (full)

Carry on past listing — attach a phone number, place a test call, run a campaign. ~10 minutes.

Concepts: Agents

Every field on an agent and what it does — system prompt, voice, LLM, auth modes, greeting modes.

API Reference

Every endpoint with try-it. Generated from the same OpenAPI spec the SDKs are built on.

Manage from AI

Hand the API to Claude, ChatGPT, or Codex and have them build agents for you.