{"uid":"cap_f47J-WK2sOpYl-2rGtl50","slug":"palmyr-communications-outbound-phone-call-8ee30334","name":"Palmyr Communications - Outbound Phone Call","description":"Place an outbound phone call from a number you own or have shared access to, with optional TTS or audio playback.","url":"https://palmyr.ai/phone/numbers/:id/call","method":"POST","headers":{},"bodySchema":{"properties":{"input":{"properties":{"body":{"type":"object","additionalProperties":true}}},"output":{"properties":{"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ps5pXlYbC5QwEYznosxQV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Places an outbound phone call from a wallet-owned or shared phone number, with optional TTS or audio playback.","exampleAgentPrompt":"Call +1-415-555-0192 using my Palmyr number (number ID: pn_abc123) and read them this message: 'Your appointment is confirmed for tomorrow at 3pm. Please call us back if you need to reschedule.'","exampleUseCases":[{"title":"Automated appointment reminder call","prompt":"Use my Palmyr phone number (ID: pn_xyz789) to call +1-212-555-0847 and say: 'Hi, this is a reminder that your dentist appointment is tomorrow at 10am. Press 1 to confirm or call us back to reschedule.'"},{"title":"Agent alert via voice call","prompt":"My monitoring agent just detected an outage — call my on-call engineer at +1-650-555-0334 from number pn_alert01 and say: 'Critical alert: the production database is unreachable. Immediate action required.'"},{"title":"Customer order status notification","prompt":"Call customer +1-303-555-0761 from my Palmyr number pn_shop42 and read them: 'Your order number 8821 has shipped and will arrive by Thursday. Thank you for shopping with us.'"}],"resultDescription":"Returns a call record including a unique call ID, the originating and destination numbers, call status (e.g. initiated, ringing, completed), and a timestamp. The agent can use the call ID to track or reference the call later.","failureModes":["Number ID not owned or not shared with calling wallet — returns 403 Forbidden","Destination number is invalid or unreachable — call fails to connect","Insufficient USDC balance for $0.10 per-call fee — returns 402 Payment Required","TTS text too long or audio URL inaccessible — call placed but playback may fail","Rate limiting on outbound calls from the number — returns 429 Too Many Requests","Number is a temp/disposable number that has expired — returns 404 Not Found"],"whenToPreferThis":"Use this endpoint when an AI agent needs to proactively reach a person by voice — for notifications, alerts, reminders, or automated announcements — using a phone number it already owns or has shared access to on the Palmyr platform. It is distinct from SMS endpoints because it initiates a live phone call, optionally with TTS or audio. Prefer this over third-party telephony APIs (Twilio, etc.) when operating within the Palmyr agent infrastructure stack and paying via USDC on Solana or Base with x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:38:37.473Z","isFirstParty":false}