Developers

Build with the ChatTempMail API

Temporary email with AI superpowers — REST API, OpenAPI 3.1 spec, MCP server, an agent skill, and webhooks. Get an API key and a disposable inbox in under a minute.

Quickstart

Three calls to your first verification code. Base URL: https://chat-tempmail.com. All endpoints accept X-API-Key or Authorization: Bearer.

1) List available domains

curl https://chat-tempmail.com/api/email/domains \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"

2) Create a disposable address (1 hour)

curl -X POST https://chat-tempmail.com/api/emails/generate \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "test", "expiryTime": 3600000, "domain": "chat-tempmail.com"}'

3) Poll for messages

curl https://chat-tempmail.com/api/emails/{emailId} \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"

Machine-readable resources

Predictable URLs agents can discover by name:

OpenAPI 3.1 spec

Full REST API schema with operationIds, typed parameters and response schemas. Also at /api/openapi.json and /.well-known/openapi.json.

llms.txt

Site + API overview in markdown, with a when-to-use section for agents. Served as text/markdown when you send Accept: text/markdown.

MCP server

Native tool access for Claude, Cursor and VS Code. Runs locally via npm: mcp-server-tempmail.

Agent skill

Installable skill that teaches coding agents the full create-inbox → poll → AI-process workflow.

CLI & MCP package

npx mcp-server-tempmail works standalone as a CLI-style tool; official npm package.

Authentication

No OAuth dance needed: create an API key on your Profile page, send it as a header. Keys carry the same permissions as your account — regenerate immediately if leaked.

1Sign in and open your Profile page
2Create an API key (it is shown once — store it securely)
3Send X-API-Key: YOUR_API_KEY (or Authorization: Bearer YOUR_API_KEY) with every request

X-API-Key: YOUR_API_KEY

Webhooks

Instead of polling, configure a webhook (POST /api/webhook) and ChatTempMail will POST every incoming message to your URL with an X-Webhook-Event: new_message header. Respond 2xx quickly; failed deliveries are retried, so keep the endpoint idempotent.

Configure a webhook

curl -X POST https://chat-tempmail.com/api/webhook \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-server.com/webhook", "enabled": true}'

Sandbox & rate limits

There is no separate sandbox: every account can create temporary addresses for free. Paid plans unlock AI operations (summarize/translate/QA/extract), permanent addresses, and attachments. Listing endpoints return 20 items per page; pagination is cursor-based. AI endpoints have daily per-role limits surfaced in X-AI-Remaining response headers.

Support

Questions, bug reports, feature requests:

GitHub Email