AI phone call API
Give your app a phone call—not a voice stack.
Send ClawCall a destination and a clear task. It handles the phone tree, hold time, conversation, and authorized voicemail, then returns the network outcome and captured transcript evidence when present. Use REST from a trusted backend or hosted OAuth MCP from a compatible AI agent.
- You provide
- Destination, task, and boundaries
- ClawCall handles
- IVR, hold, and the conversation
- Your app receives
- Outcome, plus transcript evidence when present
Copy the request. Read the response.
One outbound call to a US +1 number is one authenticated request. ClawCall returns a call identifier right away, then reports the network outcome plus captured transcript evidence when present after the call ends.
POST https://api.clawcall.dev/call returns a call_id immediately. Exact request, response, polling, and structured-error details live in the API reference.
curl -X POST https://api.clawcall.dev/call \
-H 'Content-Type: application/json' \
-H 'X-Api-Key: clawcall_sk_...' \
-d '{
"to": "+1XXXXXXXXXX",
"task": "Call the pharmacy and ask whether my refill is ready for pickup",
"voice": "chris"
}'Replace clawcall_sk_... with a server-side API key, and keep it out of client code, prompts, and public repositories. Poll until lifecycle is finalized. The example is trimmed. outcome: "answered" only means the line connected, so use captured transcript evidence when present to judge whether the task succeeded. transcript and recording_url can be null. The field-by-field contract lives in the API documentation.
Add phone work without rebuilding telephony
ClawCall gives your product a finished call. Authorization, application state, and the final user decision stay with you.
Delegate the messy middle
ClawCall dials, navigates phone menus, waits through queues, speaks with the person who answers, and follows your task boundaries.
Keep authority in your product
Your trusted system confirms the destination, goal, known facts, fallbacks, and the decisions the caller may or may not make.
Keep continuity outside the call
Your application stores its request correlation, the ClawCall call identifier, the latest state, transcript retrieval, and any follow-up decision.
Know what happened on the line
The network outcome describes the connection. The transcript evidence actually captured tells you whether the real-world task succeeded.
Choose the connection that fits your runtime
Both paths reach the same calling capability. The difference is who owns authorization and orchestration.
Your backend owns the workflow
Use the REST API when your server can protect a ClawCall API key, bind each call to a user or approved workflow, and persist the result.
Open the API reference →Compatible AI host · OAuthThe agent gets bounded ClawCall tools
Use https://api.clawcall.dev/mcp when the host supports remote Streamable HTTP MCP and OAuth. The host receives revocable tokens, not a ClawCall API key.
Keep secrets out of prompts and browsers
Never place a ClawCall API key in client JavaScript, a consumer prompt, a URL, or a public repository. Use a trusted backend or the hosted OAuth flow.
Retries stay inside the user’s authority
A callback, retry, or small call set can support one objective. Each one must keep the authorized goal, destinations, and decision limits.
ClawCall runs the call; your app keeps continuity
A clear split of responsibility makes each call easier to recover, explain, and act on inside a larger workflow.
- Before the callPersist the approved briefing: the principal, destination, objective, known facts, alternatives, fallback behavior, and any decision that must return to the user.
- While it runsStore your own request or job ID beside the ClawCall call identifier, so a worker restart does not orphan the external action.
- When it endsReview transcript evidence when present. Record whether retrieval succeeded and which captured evidence supports the conclusion your product shows the user.
- For audio reviewTreat recording access as temporary. Recording links expire. Keep the durable call reference and retrieval state your product needs; use the transcript for longer-lived task review.
Return evidence your product can use
ClawCall separates what happened on the phone network from what happened in the task, so your app does not mistake a connected line for a finished goal.
Model exactly ten terminal outcomes
The network result is always one of these values.
answeredno_answerbusyrejectedinvalid_numberunreachablenetwork_errorcancelledsystem_errorfailed
Judge success from the transcript
Captured transcript evidence, when present, shows what was asked, answered, agreed, refused, or left unresolved. Do not treat
answeredas proof that the user’s goal succeeded.Keep mailbox behavior in context
Voicemail is not a network outcome. ClawCall can leave a concise message when the user’s instructions authorize it; captured transcript evidence records what happened when present.
Return choices to the user
If the call surfaces a new price, alternative, verification request, or commitment outside the briefing, pause instead of inferring consent. When the user joins, post-join recording and transcription follow the account’s “Record bridged conversations” setting, so captured evidence may end at the bridge.
Best fit for the current ClawCall API
Use ClawCall for focused, user-directed US phone work.
- Language and destination
- English-language calls to US +1 numbers.
- On-call work
- IVR navigation, hold, conversation, instructed voicemail, live join, and transcript-backed results.
- Access
- REST from a trusted application, or 12 bounded tools through OAuth-protected hosted MCP for compatible AI hosts.
- Inbound
- Unlimited Reserve adds a private reserved caller-ID number; Reserve Plus adds AI inbound answering on an active reserved number.
- Pricing
- The free trial includes 30 calls and 30 minutes, whichever lasts later, with no credit card. Paid plans are $4.99, $8.99, and $14.99 per month.
- Limits
- Not for robocalls, predictive dialing, or bulk/high-volume automated outreach or sales campaigns. There is no current HIPAA, PCI, or SOC 2 attestation.
Confirm the fit before you build
Hear a real call, check the plan and security posture for the workload you plan to ship, and compare ClawCall with other phone agent APIs.
See ClawCall complete a real call
After the call ends, review the network outcome and captured transcript evidence when present.
Try a free call →PlansPick a plan and inbound eligibility
Compare the trial, flat monthly plans, and which plan adds AI inbound answering.
See pricing →SecurityReview data handling and limits
Check current security posture, retention, and attestation boundaries before production.
Review security →AlternativesCompare AI phone agent APIs for developers
See where a finished-call API fits next to voice-agent platforms you configure yourself.
Read the comparison →ClawCall API questions
- What does ClawCall handle for my application?
- Your application provides an English-language US +1 destination, a user-directed task, known facts, and decision boundaries. ClawCall handles dialing, IVR navigation, hold time, the live conversation, and a concise voicemail when the instructions authorize one. Your application receives call state, a network outcome, and captured transcript evidence when present.
- Should my product use REST or hosted MCP?
- Use REST when a trusted backend owns the credential and application workflow. Use ClawCall’s OAuth-protected hosted MCP path when a compatible AI host supports remote Streamable HTTP MCP and OAuth. The hosted path keeps a ClawCall API key out of the AI host and exposes 12 bounded tools.
- What state should my application keep?
- Keep your user or workflow identity, the authorized destination and task boundaries, request correlation, the ClawCall call identifier, the latest observed call state, and what transcript evidence was captured. Recording links are temporary access rather than durable application state.
- Which terminal network outcomes should my application model?
- The closed set is answered, no_answer, busy, rejected, invalid_number, unreachable, network_error, cancelled, system_error, failed. Voicemail is not a network outcome. Reaching a mailbox or leaving an instructed message belongs in agent behavior and transcript context, while the network result remains one of the ten values above.
- Can one user-directed workflow place more than one call?
- Yes. A bounded objective can include a callback, a retry, or a small comparison set when the user-authorized goal and decision limits remain clear. ClawCall is not for robocalls, predictive dialing, or bulk/high-volume automated outreach or sales campaigns.
Verified product details
Behavior, connection paths, plan boundaries, and security limits come from the current first-party pages below.
- ClawCall API and hosted MCP documentation
- ClawCall for AI agents
- ClawCall pricing
- ClawCall security and data handling
- US Federal Trade Commission: Telemarketing Sales Rule guide
The FTC source is informational, not legal advice. ClawCall does not claim a reliability, latency, completion-rate, adoption, or ranking benchmark on this page.
Give your product its first phone call
Sign up free for a server-side API key. The trial includes 30 calls and 30 minutes, whichever lasts later, with no credit card.