Create virtual emails, read them via API

# 1. Create a virtual mailbox
curl -X POST https://api.mail2rest.com/api/virtualemails \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emailAddress": "test-inbox", "domainId": "..."}'

# 2. Read received emails
curl https://api.mail2rest.com/api/emails/virtual/a1b2c3d4 \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response 200:
{
  "data": [
    {
      "id": "e5f6g7h8-...",
      "from": "alice@example.com",
      "subject": "Invoice #1042",
      "bodyText": "Please find attached...",
      "bodyHtml": "<p>Please find...</p>",
      "attachments": [
        { "filename": "invoice.pdf" }
      ],
      "receivedAt": "2026-03-16T10:35:00Z"
    }
  ],
  "totalCount": 1
}

# Python — read emails from a virtual mailbox
import requests

API = "https://mail2rest.com/api"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

# Create a virtual mailbox
mailbox = requests.post(f"{API}/virtualemails", json={
    "emailAddress": "test-inbox",
    "domainId": "your-domain-id",
    "expiresAt": "2026-04-01T00:00:00Z"
}, headers=HEADERS).json()

# Read received emails
emails = requests.get(
    f"{API}/emails/virtual/{mailbox['id']}",
    headers=HEADERS
).json()

for email in emails["data"]:
    print(f"From: {email['fromAddress']} — {email['subject']}")

// Node.js — read emails from a virtual mailbox
const API = "https://mail2rest.com/api";
const headers = { "Authorization": "Bearer YOUR_API_KEY" };

// Create a virtual mailbox
const mailbox = await fetch(`${API}/virtualemails`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({
    emailAddress: "test-inbox",
    domainId: "your-domain-id",
    expiresAt: "2026-04-01T00:00:00Z"
  })
}).then(r => r.json());

// Read received emails
const emails = await fetch(
  `${API}/emails/virtual/${mailbox.id}`, { headers }
).then(r => r.json());

emails.data.forEach(e =>
  console.log(`From: ${e.fromAddress} — ${e.subject}`));