Email infrastructure built for AI agents, not adapted from human email

curl -X POST https://api.multimail.dev/v1/mailboxes \
  -H &"cm">#039;Authorization: Bearer $MULTIMAIL_API_KEY' \
  -H &"cm">#039;Content-Type: application/json' \
  -d &"cm">#039;{
    "address": "[email protected]",
    "display_name": "Procurement Agent",
    "oversight_mode": "gated_send",
    "approver_emails": ["[email protected]"]
  }&"cm">#039;

import multimail

client = multimail.Client(api_key="$MULTIMAIL_API_KEY")

"cm"># Returns immediately with status='pending' when oversight_mode='gated_send'
result = client.send_email(
    from_address="[email protected]",
    to=["[email protected]"],
    subject="PO #8821 — amended delivery schedule",
    body="Please confirm the updated delivery date of 2026-05-01 for order #8821.",
    metadata={"workflow": "procurement", "po_number": "8821"}
)

print(result.status)        "cm"># 'pending'
print(result.message_id)    "cm"># 'msg_01JXK...'
print(result.approval_url)  "cm"># approval link sent to the assigned human approver

import multimail

client = multimail.Client(api_key="$MULTIMAIL_API_KEY")

pending = client.list_pending(
    mailbox="[email protected]",
    limit=50
)

for msg in pending.messages:
    print(f"{msg.message_id} | to={msg.to[0]} | {msg.subject} | queued {msg.created_at}")

"cm"># Cancel a message before it is approved
client.cancel_message(message_id="msg_01JXK_specific_id")

import multimail
import pytest

@pytest.fixture
def client():
    return multimail.Client(api_key="mm_test_your_test_token")

def test_gated_send_creates_pending(client):
    result = client.send_email(
        from_address="[email protected]",
        to=["[email protected]"],
        subject="Test: contract renewal",
        body="Renewing contract #4492 for another 12 months."
    )
    assert result.status == "pending"
    assert result.message_id.startswith("msg_")

def test_cancel_pending_message(client):
    msg = client.send_email(
        from_address="[email protected]",
        to=["[email protected]"],
        subject="Cancellation test",
        body="This message will be cancelled before delivery."
    )
    cancelled = client.cancel_message(message_id=msg.message_id)
    assert cancelled.status == "cancelled"

from fastapi import FastAPI, Request, HTTPException
import hmac
import hashlib

app = FastAPI()
WEBHOOK_SECRET = "your_webhook_signing_secret"

@app.post("/webhooks/multimail")
async def handle_email_event(request: Request):
    body = await request.body()
    sig = request.headers.get("X-MultiMail-Signature", "")
    expected = hmac.new(
        WEBHOOK_SECRET.encode(),
        body,
        hashlib.sha256
    ).hexdigest()
    if not hmac.compare_digest(sig, expected):
        raise HTTPException(status_code=401, detail="invalid signature")

    event = await request.json()
    if event["type"] == "email.received":
        mailbox = event["data"]["mailbox"]
        message_id = event["data"]["message_id"]
        await route_to_agent(mailbox, message_id)

    return {"ok": True}

{
  "mcpServers": {
    "multimail": {
      "command": "npx",
      "args": ["-y", "@multimail/mcp-server"],
      "env": {
        "MULTIMAIL_API_KEY": "$MULTIMAIL_API_KEY",
        "MULTIMAIL_MAILBOX": "[email protected]"
      }
    }
  }
}