Appearance

Mail.cx APIEmail API

Create email addresses and receive emails via REST API. No API key required.

Quick Start
OpenAPI Spec
Interactive API
⚡

Simple REST API

Create mailboxes, fetch emails, download attachments — all via standard HTTP requests.

🔒

Token-based Auth

No API key needed. Create an account and get a JWT token instantly.

📡

Real-time WebSocket

Get instant notifications when new emails arrive via WebSocket.

🚀

Pro Features

Custom domains, webhooks, API tokens, and higher limits for power users.

Quick Start ​

bash
# 1. Get available domains
curl https://api.mail.cx/api/domains

# 2. Create a mailbox (returns a token)
curl -X POST https://api.mail.cx/api/accounts \
  -H "Content-Type: application/json" \
  -d '{"address":"myname@mail.cx","password":"mypassword123"}'

# 3. Fetch messages
curl https://api.mail.cx/api/messages \
  -H "Authorization: Bearer YOUR_TOKEN"

How it works ​

  1. Get domains — Fetch the list of available domains
  2. Create mailbox — Pick a domain and create an email address (returns a token)
  3. Use the address — Give the address to any service that requires email verification
  4. Fetch messages — Use the token to read your emails via the API

Mail.cx API Documentation