# Reseev — Instant email for AI agents

> reseev.dev provides zero-friction email identity for AI agents.
> Create a working email address with a single HTTP POST. No signup, no API keys, no human-in-the-loop.

## What is this?

Reseev ("receive" with a twist) is an email-as-a-service API designed for autonomous AI agents. An agent can create a mailbox, send real email, and receive real email — all via simple REST API calls. No authentication is required to create a mailbox.

## Quick Start

Create a mailbox (no auth required):

  POST https://api.reseev.dev/v1/mailboxes
  Content-Type: application/json

  Response 201:
  {
    "id": "mbx_k8v2x9",
    "address": "k8v2x9@reseev.dev",
    "token": "tok_live_...",
    "expires_at": "2026-03-29T15:00:00Z",
    "limits": { "sends_per_day": 20, "sends_per_week": 50, "receives_per_day": 200 }
  }

Send an email:

  POST https://api.reseev.dev/v1/send
  Authorization: Bearer tok_live_...
  Content-Type: application/json

  {
    "to": "recipient@example.com",
    "subject": "Hello from an AI agent",
    "text": "This email was sent programmatically via reseev.dev"
  }

Read received messages:

  GET https://api.reseev.dev/v1/mailboxes/{id}/messages
  Authorization: Bearer tok_live_...

Set a webhook for incoming email:

  PUT https://api.reseev.dev/v1/mailboxes/{id}/webhook
  Authorization: Bearer tok_live_...
  Content-Type: application/json

  { "url": "https://your-agent.example.com/email-hook" }

## API Base URL

  https://api.reseev.dev/v1

## All Endpoints

  POST   /mailboxes                          — Create mailbox (NO AUTH)
  GET    /mailboxes/:id                      — Get mailbox details (token)
  DELETE /mailboxes/:id                      — Delete mailbox (token)
  POST   /send                               — Send email (token)
  GET    /mailboxes/:id/messages             — List messages (token)
  GET    /mailboxes/:id/messages/:msg_id     — Get single message (token)
  DELETE /mailboxes/:id/messages/:msg_id     — Delete message (token)
  PUT    /mailboxes/:id/webhook              — Set webhook URL (token)
  DELETE /mailboxes/:id/webhook              — Remove webhook (token)
  GET    /health                             — Health check (NO AUTH)

## Authentication

All endpoints except POST /mailboxes and GET /health require a Bearer token.
The token is returned when you create a mailbox. Include it as:

  Authorization: Bearer tok_live_...

## Free Tier Limits

- 20 outbound emails per day per mailbox
- 50 outbound emails per week per mailbox
- 200 inbound emails per day per mailbox
- 10 MB storage per mailbox
- 5 MB max attachment size
- Messages retained for 7 days
- Mailbox expires after 30 days of inactivity
- Random address assigned (e.g. k8v2x9@reseev.dev)

## Pro Tier — $9/mo per mailbox

- 500 outbound emails per day
- Unlimited inbound
- 1 GB storage
- 25 MB attachments
- 90-day message retention
- Mailbox never expires
- Custom local part (your-name@reseev.dev)
- Webhook delivery with 10 retries

## Machine-Readable Resources

- Service manifest: https://reseev.dev/.well-known/agent.json
- OpenAPI spec: https://api.reseev.dev/v1/openapi.yaml
- This file: https://reseev.dev/llms.txt

## Contact

- Email: hello@reseev.dev
- Website: https://reseev.dev