Python SDK

Updated July 2026

A first-party qalyb-python package is on the roadmap. Until it ships, you're not stuck — the REST API is fully usable from Python with httpx or requests, and there's a working example below.

Coming soon:
we're polishing qalyb-python with full type stubs and async support. Want early access? Email us at hello@qalyb.ai.

In the meantime

Every endpoint is plain JSON over HTTPS, so any HTTP client works. Here's a minimal example with httpx:

qalyb_client.py · python
import os
import httpx

QALYB_API_KEY = os.environ["QALYB_API_KEY"]
BASE = "https://api.qalyb.ai"

def place_call(agent_id: str, phone_number: str) -> dict:
    response = httpx.post(
        f"{BASE}/v1/calls",
        headers={"Authorization": f"Bearer {QALYB_API_KEY}"},
        json={"agentId": agent_id, "phoneNumber": phone_number},
        timeout=30.0,
    )
    response.raise_for_status()
    return response.json()

call = place_call("agt_abc123", "+971501234567")
print(call["id"], call["status"])

What you'll get when the SDK ships

  • Sync and async clients (Qalyb + AsyncQalyb).
  • Pydantic models for every request and response.
  • Automatic retries with backoff for transient errors.
  • Helpers for webhook signature verification.

Looking for the typed client today? See the TypeScript SDK.

Was this guide helpful?