# Palmyr Communications - Outbound Phone Call

> Palmyr Communications - Outbound Phone Call is a paid API for AI agents from palmyr.ai, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Places an outbound phone call from a wallet-owned or shared phone number, with optional TTS or audio playback.

## Facts

- Endpoint: POST https://palmyr.ai/phone/numbers/:id/call
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/palmyr-communications-outbound-phone-call-8ee30334
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f47J-WK2sOpYl-2rGtl50

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability palmyr-communications-outbound-phone-call-8ee30334 -d '<json body>'
```

Example prompt: 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.'

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Place an outbound phone call from a number you own or have shared access to, with optional TTS or audio playback.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "properties": {
    "body": {
     "type": "object",
     "additionalProperties": true
    }
   }
  },
  "output": {
   "properties": {
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/palmyr-communications-outbound-phone-call-8ee30334/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from palmyr.ai](https://www.zero.xyz/host/palmyr.ai/llms.txt)