# Crier Email Relay

> Crier Email Relay is a paid API for AI agents from crier.vimabrosta.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-18).

Send a one-time email from an AI agent to a person via a managed relay, with rate limiting, bounce/complaint suppression, and delivery status polling.

## Facts

- Endpoint: POST https://crier.vimabrosta.com/v1/email
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crier-email-relay-7d36c4fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vq6fw1WsZSRNJOwTAcjr4

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 crier-email-relay-7d36c4fa -d '<json body>'
```

Example prompt: Send an email to jane.doe@example.com with the subject 'Your order is ready' and the message 'Hi Jane, your custom order #4521 has been packed and is ready for pickup at our warehouse. Thanks for your patience!' — reply-to should go to support@myshop.com and show the sender as 'MyShop Support'.

## When to prefer this

Choose this endpoint when an AI agent needs to send a single transactional or notification email to a person without setting up SMTP infrastructure or creating an account. It is ideal for low-volume, agent-initiated outreach where built-in rate limiting, bounce suppression, and unsubscribe compliance are required. At $0.01 per send with no subscription, it suits sporadic or pay-as-you-go agent workflows. Prefer alternatives like SendGrid or Mailgun when you need bulk sending, custom sending domains, or high-volume throughput beyond 12 emails/day per recipient.

## Known failure modes

- Recipient has previously bounced, complained, or unsubscribed — request refused for all future senders
- Rate limit exceeded: more than 4 emails/hour or 12 emails/day to the same address
- Invalid email address format for 'to' or 'reply_to' fields
- Text body exceeds 20,000 character limit
- Subject exceeds 200 character limit
- HTML body exceeds 64KB limit
- Payment not provided or invalid — x402 payment of $0.01 USDC required
- Relay delivery failure after retries — status endpoint will reflect final failed state

## How this service works

Send an email from an AI agent to a person: subject, plain text (HTML optional), an optional reply-to. Delivered from a fixed relay address with a footer naming the relay and an unsubscribe link, retried on failure, with a status endpoint you can poll. Addresses that bounce, complain, or unsubscribe are refused to every future sender. Up to 4 per hour and 12 per day to one address. One-time $0.01, no account needed.

## Output

A JSON response containing a message ID and a status endpoint URL that the agent can poll to check whether the email was accepted, queued, delivered, bounced, or failed. If the recipient has previously bounced, complained, or unsubscribed, the request is refused immediately with an error.

## 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",
     "required": [
      "to",
      "subject",
      "text"
     ],
     "properties": {
      "to": {
       "type": "string",
       "format": "email"
      },
      "html": {
       "type": "string",
       "description": "Optional HTML body, 64KB max; the same footer is appended."
      },
      "text": {
       "type": "string",
       "maxLength": 20000,
       "description": "Plain text body. A footer naming the relay and an unsubscribe link is appended."
      },
      "subject": {
       "type": "string",
       "maxLength": 200
      },
      "reply_to": {
       "type": "string",
       "format": "email"
      },
      "from_name": {
       "type": "string",
       "maxLength": 40,
       "description": "Shown as \"<from_name> via Crier\"; the address is always the relay's."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "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/crier-email-relay-7d36c4fa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crier.vimabrosta.com](https://www.zero.xyz/host/crier.vimabrosta.com/llms.txt)