kaicalls 0.1.0

Official KaiCalls SDK — give your AI agent a phone. Outbound calls, agents, leads, SMS, transcripts, and webhooks.

kaicalls

Official Python SDK for the KaiCalls API — give your AI agent a phone. Outbound calls, agents, leads, SMS, transcripts, webhooks, and platform APIs.

• Python 3.9+, one dependency (requests)
• Docs: https://www.kaicalls.com/docs/api · Live OpenAPI: GET /api/v1/openapi.json

Install

pip install kaicalls

Quick start

from kaicalls import KaiCalls

kai = KaiCalls(api_key="kc_live_...")

# Make an outbound call — the agent auto-enriches with CRM context
call = kai.calls.create(
    agent_id="uuid-abc123",
    to="[phone]",
    name="John Smith",
    context="Following up on his kitchen remodel inquiry",
)

# Block until the call finishes, then read the AI summary
result = kai.calls.wait(call.id)
print(result.summary)

Responses support attribute access (call.id, result.summary, call.quality_dimensions.empathy) and behave like dicts.

No account yet? Sign up via the API

from kaicalls import KaiCalls, signup

account = signup(
    business_name="Smith Law Firm",
    email="[e-mail]",
    plan_id="starter",
)
# account.api_key works immediately; send the owner to account.checkout_url
kai = KaiCalls(api_key=account.api_key)

What's wrapped

Resource	Methods
kai.calls	create, get, list, wait
kai.recordings	get
kai.agents	list, get, create, update, versions
kai.leads	list, get, create, update, audit
kai.sms	send, update_prompt, conversations, messages
kai.transcripts	list
kai.phone_numbers	list, available, assign, release
kai.workspaces	list, get, create, update (lifecycle actions)
kai.webhooks	list, create, delete, test, rotate_secret
kai.analytics	dashboard, calls, funnel, agents, weekly, businesses
kai.evals	create, list, get, update, delete, run, get_run
kai.events	list, deliveries, replay, backfill
kai.communication_runs	validate, preview, create, list, pause, cancel, jobs, attempts
kai.discovery	capabilities, openapi, schemas, health
kai.account	balance, usage

Anything not wrapped yet is reachable through the escape hatch:

kai.request("GET", "/api/sdr/pipeline", query={"businessId": "uuid-biz"})

Errors

All non-2xx responses raise KaiCallsError with .status, .code (e.g. unauthorized, forbidden, rate_limited), and .body.

from kaicalls import KaiCallsError

try:
    kai.calls.create(agent_id=agent_id, to=to)
except KaiCallsError as err:
    if err.code == "rate_limited":
        ...  # back off and retry

Notes

• Get an API key at https://www.kaicalls.com/dashboard/settings/api. New keys default to read-only scopes — request write scopes (calls:write, sms:write, …) when creating the key.
• Phone numbers are E.164 ([phone]).
• API reference: https://www.kaicalls.com/docs/api · Errors: https://www.kaicalls.com/docs/api/errors