# Mermail Agent Mailbox Draft Creator

> Mermail Agent Mailbox Draft Creator is a paid API for AI agents from console.mermail.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Creates an email draft in a specified AI agent mailbox, optionally as a reply within an existing thread

## Facts

- Endpoint: POST https://console.mermail.app/api/agent/v1/mailboxes/%7BmailboxId%7D/drafts?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mermail-agent-mailbox-draft-creator-a6de4e06
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JTdsbHwfQJMBkwp-yqW95

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 mermail-agent-mailbox-draft-creator-a6de4e06 -d '<json body>'
```

Example prompt: Save a draft email in my Mermail mailbox mb_abc123 to leads@acme.com with the subject 'Following up on your inquiry' and a plain text body saying 'Hi there, just checking in on our earlier conversation — happy to answer any questions you have.'

## When to prefer this

Use this endpoint when an AI agent needs to compose and save an outgoing email draft within a Mermail-managed mailbox before sending — especially useful for sales outreach, customer support workflows, or any scenario where a human or automated review step is needed before delivery. Prefer this over direct send endpoints when the agent needs to queue messages, allow for human review, or build up threaded replies incrementally.

## Known failure modes

- Invalid or non-existent mailboxId returns 404 not found
- Missing required fields (body or recipient) may return 400 bad request
- Invalid email address format in to/cc/bcc fields causes validation error
- Referencing a non-existent thread_id may return an error or orphan the draft
- Payment failure via x402 protocol returns 402 Payment Required
- Malformed attachment objects in the attachments array cause 400 errors
- Unsupported body_format value outside 'html' or 'text' enum returns validation error

## How this service works

An inbox and wallet for your AI agent. Find and nurture sales leads, resolve customer support, and handle online purchases with controlled payments.

## Output

Returns a JSON object containing the newly created draft's unique ID, creation date, sender address, recipient address, subject line, and a scan_status field confirming the draft content has been scanned (e.g. 'clean').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cc": {
   "oneOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    }
   ]
  },
  "to": {
   "oneOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    }
   ]
  },
  "bcc": {
   "oneOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    }
   ]
  },
  "body": {
   "type": "string"
  },
  "subject": {
   "type": "string"
  },
  "draft_id": {
   "type": "string"
  },
  "thread_id": {
   "type": "string"
  },
  "attachments": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "body_format": {
   "enum": [
    "html",
    "text"
   ],
   "type": "string"
  },
  "in_reply_to": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "draft_1",
  "date": "2026-09-20T00:00:00.000Z",
  "sender": "noreply@example.com",
  "subject": "Verification code",
  "recipient": "agent@mermail.app",
  "scan_status": "clean"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mermail-agent-mailbox-draft-creator-a6de4e06/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from console.mermail.app](https://www.zero.xyz/host/console.mermail.app/llms.txt)