# AgentMail Reply via Vaaya

> AgentMail Reply via Vaaya is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-16).

Sends a reply to a specific email message in an AgentMail inbox using the provided inbox and message identifiers

## Facts

- Endpoint: POST https://vaaya.ai/api/run/agentmail/reply
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentmail-reply-via-vaaya-509d4f5d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lG9gKJx23IPW3yT2ym7RS

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 agentmail-reply-via-vaaya-509d4f5d -d '<json body>'
```

Example prompt: Reply to message msg_abc123 in inbox inbox_xyz456 with the text: 'Thanks for reaching out — we'll get back to you within 24 hours.'

## When to prefer this

Use this endpoint when your agent needs to reply to a specific email thread managed through AgentMail, especially in agentic workflows involving inbound email handling, customer support automation, or sales outreach sequences. Prefer this over generic email APIs when already operating within the AgentMail inbox ecosystem via Vaaya.

## Known failure modes

- Missing or invalid inbox_id returns a 400 or 404 error
- Missing or invalid message_id causes the reply to fail
- Both text and html body fields omitted may result in an empty or rejected message
- Network or upstream AgentMail API errors may return 500-level responses
- Payment failure (insufficient USDC balance) prevents the call from executing via x402

## How this service works

Give an AI agent a credit account. Set a limit and a spending policy, and the agent makes approved, metered purchases from providers that accept Vaaya.

## Output

A confirmation object indicating the reply was sent, typically including the sent message details or a success status tied to the AgentMail API response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "http://json-schema.org/draft-07/schema#",
     "required": [
      "message_id"
     ],
     "properties": {
      "html": {
       "type": "string"
      },
      "text": {
       "type": "string"
      },
      "inbox_id": {
       "type": "string",
       "minLength": 1
      },
      "message_id": {
       "type": "string",
       "minLength": 1
      }
     },
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-reply-via-vaaya-509d4f5d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)