Skip to content

Signing up for Discord? Some of our domains are accepted there. See which ones on the Domains page.

CyberTemp
Developers

The temp mail API built for developers

Disposable inboxes you can drive from code: read mail over a simple REST API, get HMAC-signed webhooks, plug into MCP agents. Every account gets a free API key; paid plans from €1.99/mo raise the limits.

# Any address on a CyberTemp domain works: the inbox is created on first read.
# $RANDOM gives you a fresh address, so you never share an inbox with someone else.
curl "https://api.cybertemp.xyz/[email protected]" \
  -H "X-API-KEY: tk_..."

# [{"id":"...","from":"[email protected]","subject":"Your code is 482917",
#   "text":"...","html":"...","date":"2026-05-17T09:31:00.000Z"}]

Built for these workflows

Most CyberTemp API users are doing one of these three things.

Email testing in CI/CD

Use disposable inboxes in Playwright, Puppeteer, or Cypress runs. No shared inboxes, no leaked secrets in test fixtures.

OTP flows for QA automation

Point your signup flow at a fresh address, poll GET /getMail and read the code from the newest message. No shared inboxes, no flaky test mail servers.

AI agents and MCP integrations

Drop our MCP server into Claude or Cursor in seconds. Agents can sign up, confirm, and act on email-gated flows autonomously.

Features

API key auth

Per-account keys, per-device CLI tokens. Revocable from the dashboard.

Webhooks

Elite+

Receive new-message notifications at your endpoint. HMAC-signed.

OTP extraction

On any plan, read the newest message with one GET and pull the code out with a short regex (see the samples below). From Core up, POST /extract-otp waits for the email and returns just the code.

IMAP

Eco+

Connect your existing mail clients and tooling.

Custom domains

Bring your own — DNS setup support included.

MCP server

Plug-and-play tools for Claude Desktop and Cursor.

CLI

Coming soon. Until it ships, use the REST API or the MCP server.

SDKs

Client libraries for Python, Go and Rust, or plain HTTP from any language.

Real code, not pseudo-code

Wait for an OTP in a Playwright test

import { test, expect } from "@playwright/test";

const API = "https://api.cybertemp.xyz";
const headers = { "X-API-KEY": process.env.CYBERTEMP_API_KEY! };

// Polls /getMail until the newest message contains a 4-8 digit code.
async function waitForOtp(email: string, timeoutMs = 30_000) {
  const deadline = Date.now() + timeoutMs;
  while (Date.now() < deadline) {
    const res = await fetch(`${API}/getMail?email=${encodeURIComponent(email)}`, { headers });
    if (!res.ok) throw new Error(`CyberTemp API returned ${res.status}: ${await res.text()}`);
    const mails: { subject: string; text: string }[] = await res.json();
    const otp = mails[0] && `${mails[0].subject}\n${mails[0].text}`.match(/\b\d{4,8}\b/);
    if (otp) return otp[0];
    await new Promise((r) => setTimeout(r, 2000));
  }
  throw new Error("Timed out waiting for the OTP email");
}

test("signup verifies via OTP", async ({ page }) => {
  const email = `e2e${Date.now()}@cybertemp.xyz`;
  await page.goto("https://example.com/signup");
  await page.fill("#email", email);
  await page.click("button[type=submit]");

  const otp = await waitForOtp(email);
  await page.fill("#otp", otp);
  await expect(page).toHaveURL(/dashboard/);
});

Webhook receiver (Elite + Team plan)

Subscribe an HTTPS endpoint to get an HMAC-SHA256-signed POST whenever a message lands in one of your inboxes. Each delivery is tried once (10-second timeout) and failures are not retried, so also poll GET /getMail now and then to catch anything you missed.

Event types
  • message.received — a new email lands in one of your inboxes
  • test_ping — fired from the dashboard "Test" button
Headers we set
  • X-Cybertemp-Signature: sha256=<hmac_hex>
  • X-Cybertemp-Event: message.received
  • X-Cybertemp-Delivery: <unique_id>
  • Content-Type: application/json
  • User-Agent: Cybertemp-Webhook/1.0
Payload shape
{
  "id": "7c4f...",
  "type": "message.received",
  "timestamp": "2026-05-17T09:31:00.000Z",
  "data": {
    "inbox_id": "[email protected]",
    "inbox_address": "[email protected]",
    "message_id": "9a1b...",
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Your verification code",
    "snippet": "Your code is...",
    "received_at": "2026-05-17T09:31:00.000Z"
  }
}
Verify the signature
import crypto from "node:crypto";
import express from "express";

const app = express();
// IMPORTANT: keep the raw buffer for HMAC. Express's json() throws it away.
app.use("/webhooks/cybertemp",
  express.raw({ type: "application/json" }));

app.post("/webhooks/cybertemp", (req, res) => {
  const header = req.header("x-cybertemp-signature") || "";
  const expected = "sha256=" + crypto
    .createHmac("sha256", process.env.CT_WEBHOOK_SECRET)
    .update(req.body)         // req.body is a Buffer thanks to express.raw
    .digest("hex");

  // timingSafeEqual throws on a length mismatch, so check the length first
  // (a missing or truncated header must be a 401, not a 500).
  const a = Buffer.from(header);
  const b = Buffer.from(expected);
  if (a.length !== b.length || !crypto.timingSafeEqual(a, b)) {
    return res.status(401).end();
  }

  const event = JSON.parse(req.body.toString("utf8"));
  console.log(event.data.from, "→", event.data.subject);
  res.status(200).end();
});

Manage endpoints and signing secrets in Settings → Webhooks. Each endpoint has a Test button that sends a test event, so you can check your signature verification without waiting for real mail.

Agent flow via MCP

User: Sign me up at acme.test with a throwaway email.
Wait for the verification code and paste it back.

Agent:
- create_inbox()                      -> [email protected]
- POST acme.test/signup { email: [email protected] }
- wait_for_message([email protected], timeout=60)
                                      -> "Your code is 482917"
- POST acme.test/verify { otp: 482917 }
Done.

MCP server

Quickstart in 3 steps

Step 1

Sign up

Create a free account. No credit card required.

Sign up
Step 2

Get an API key

Any account can create keys under Settings → API keys. Free keys get Free-plan limits; paid plans raise them.

Get an API key
Step 3

Make a request

curl -H "X-API-KEY: tk_..." \
  "https://api.cybertemp.xyz/[email protected]"
Read the API docs

From €1.99/mo

Start free with an API key. Paid plans raise rate limits and inbox caps; Elite adds webhooks.