# Palmyr Communications - Read Inbox Messages

> Palmyr Communications - Read Inbox Messages is a paid API for AI agents from palmyr.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Retrieves decrypted messages from a specific email inbox you own, authenticated by matching payment wallet.

## Facts

- Endpoint: GET https://palmyr.ai/email/inboxes/:id/messages
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/palmyr-communications-read-inbox-messages-18d45130
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wDlYqgg5PCsNXoXg-MSC9

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-read-inbox-messages-18d45130
```

Example prompt: Pull all the decrypted messages from my Palmyr inbox ID inbox_abc123 — I want to read what's arrived there.

## When to prefer this

Use this endpoint when you need to programmatically read the contents of a Palmyr-hosted email inbox you own, especially in autonomous agent workflows that pay per call with USDC via x402. Prefer this over SMS endpoints when the communication channel is email rather than SMS.

## Known failure modes

- Wallet address does not match inbox owner — returns 401/403 unauthorized
- Inbox ID not found — returns 404
- No messages in inbox — returns empty list
- Payment failure or insufficient USDC balance — returns 402
- Inbox ID malformed or invalid — returns 400

## How this service works

Read decrypted messages from an inbox you own. Payment wallet must match the inbox wallet.

## Output

A list of decrypted messages from the specified inbox, including message contents and metadata. Access is granted only when the paying wallet matches the inbox owner wallet.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "properties": {
    "queryParams": {
     "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-read-inbox-messages-18d45130/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)