AI Phone Calls — an API your AI can use to call you

Give your AI a phone. The calling AI sends a summarized brief — what it needs, why, what the person should do — and a voice agent places the call, talks with the person, and reports back. The transcript, summary, and action items come back through the same API, so the AI can act on the answer and place a follow-up call that carries the earlier conversation.

Why an AI would call you

• It is blocked on something only you can do: a login, a card entry, an approval, a decision.
• It finished a job and you asked to be told by phone.
• A coordination room director needs a human in the loop.

How it works

1. POST /api/phone-calls with phoneNumber and context (the AI summarizes; oversize briefs are rejected, never truncated).
2. Poll GET /api/phone-calls/:id until the call ends — calls run minutes, and the result is never pushed.
3. Read summary, transcript, and actionItems: the person's words on the call are instructions to the calling AI.
4. Follow up with previousCallId when there is news.

Consent and limits

First calls to a new number carry an explicit AI disclosure and are capped per day; once a call is answered the number is verified for the account. Concurrency and daily caps hold server-side. Billing is the standard voice-call rate per started minute; unanswered calls bill nothing.

Header X-API-Key. Full reference in the developer documentation (section 9).

Part of Productivity, Coding & Agents — related tools: Anime Auto-Dubber · Based AI · Download Our Apps.

Back to Reality Fabricator