Skip to main content
CallsClient is reachable on every Kataven client as client.calls. Each method maps to one HTTP endpoint on the Hub API; links to the underlying spec entry are inline below. Place outbound voice calls. The server enforces caller-ID ownership and per-tenant cost caps before dispatching to the carrier.

​
Methods at a glance

MethodHTTPSummary
originatePOST /api/v1/calls/originateOriginate an outbound call

​
Reference

​
client.calls.originate(...)

Originate an outbound call HTTP — POST /api/v1/calls/originate · API reference → 
    def originate(self, from_number: str, to_number: str, agent_id: str) -> Dict[str, Any]:
from_number must be a tenant-owned, outbound-enabled E.164 number. Cap-exceeded calls return 429 (RateLimitError). Places an outbound call from one of your registered phone numbers to an arbitrary E.164 destination using a configured agent. Subject to per-tenant cost caps (see /api/v1/call-limits).