Read disposable inboxes
with any IMAP client.

# GitHub Actions — read OTP via IMAP
- name: Get OTP
  run: |
    python - <<'EOF'
    import imaplib, email, time, re

    m = imaplib.IMAP4_SSL("imap.freecustom.email", 993)
    m.login("ci@addmy.space", "$" + "{{ secrets.FCE_API_KEY }}")
    m.select("INBOX")
    time.sleep(3)  # wait for delivery
    _, ids = m.search(None, "UNSEEN")
    _, data = m.fetch(ids[0].split()[-1], "(RFC822)")
    body = email.message_from_bytes(data[0][1]).get_payload()
    otp = re.search(r"\b(\d{6})\b", body).group(1)
    print(f"OTP={otp}")
    m.logout()
    EOF

// playwright.test.ts — IMAP-based OTP retrieval
import { test, expect } from "@playwright/test";
import imaps from "imap-simple";

test("sign-up flow", async ({ page }) => {
  const inbox = "test-" + Date.now() + "@addmy.space";
  // Register inbox via FCE API first
  await page.goto("https://example.com/signup");
  await page.fill("[name=email]", inbox);
  await page.click("[type=submit]");

  // Read OTP via IMAP
  const conn = await imaps.connect({
    imap: { user: inbox, password: process.env.FCE_API_KEY!,
            host: "imap.freecustom.email", port: 993, tls: true },
  });
  await conn.openBox("INBOX");
  await page.waitForTimeout(3000);
  const msgs = await conn.search(["UNSEEN"], { bodies: ["TEXT"] });
  const body  = msgs[0].parts[0].body as string;
  const otp   = body.match(/\b(\d{6})\b/)![1];
  conn.end();

  await page.fill("[name=otp]", otp);
  await page.click("[type=submit]");
  await expect(page).toHaveURL("/dashboard");
});

import imaplib, email, re
from concurrent.futures import ThreadPoolExecutor
import requests

FCE_KEY  = "fce_your_api_key"
API_BASE = "https://api2.freecustom.email/v1"

def get_otp(inbox: str) -> str:
    """Fetch the latest 6-digit OTP from an IMAP inbox."""
    with imaplib.IMAP4_SSL("imap.freecustom.email", 993) as m:
        m.login(inbox, FCE_KEY)
        m.select("INBOX")
        _, ids = m.search(None, "UNSEEN")
        for num in reversed(ids[0].split()):
            _, data = m.fetch(num, "(RFC822)")
            body = email.message_from_bytes(data[0][1]).get_payload(decode=True)
            if body:
                match = re.search(rb"\b(\d{6})\b", body)
                if match:
                    return match.group(1).decode()
    return ""

# Generate 100 inboxes
r = requests.post(f"{API_BASE}/inboxes/generate",
    headers={"Authorization": f"Bearer {FCE_KEY}"},
    json={"count": 100, "parseCode": True})
inboxes = [i["email"] for i in r.json()["inboxes"]]

# Parallel OTP fetch
with ThreadPoolExecutor(max_workers=20) as pool:
    otps = list(pool.map(get_otp, inboxes))
print(otps[:5])