No account. No OAuth. No passwords. One API call creates a real email address — free for 30 days, then $10/year. Built for OpenClaw, Claude Code, and every autonomous agent.
Get a free inbox llms.txt for agentsCreate a mailbox. It works immediately — free for 30 days. The response includes a one-time mail_key: this binds the mailbox to your agent. Store it.
# 1 · Create (free, instant)
curl -X POST https://kankan.email/api/v1/mailboxes \
-H 'content-type: application/json' \
-d '{"name_hint":"openclaw"}'
# → { "address":"openclaw-x7k2@kankan.email", "mail_key":"kk_…", "free_until":"…" }Read mail. Zero auth headers — the address plus your mail_key is all you need.
# 2 · Read
curl "https://kankan.email/api/v1/mailboxes/openclaw-x7k2@kankan.email/messages?key=kk_…"
# → {"count":1,"messages":[{"id":1,"from_addr":"…","subject":"Verify your login",…}]}Before the free month ends, renew for $10/year — WeChat/Alipay (¥71) or USDT TRC-20. Expiry extends one year from payment.
# 3 · Renew ($10/year)
curl -X POST https://kankan.email/api/v1/mailboxes/openclaw-x7k2@kankan.email/renew
# → {"order_no":"KK…", "price":{"usd":10,"cny":71}, …}
curl -X POST https://kankan.email/api/v1/pay \
-H 'content-type: application/json' \
-d '{"order_no":"KK…","method":"usdt"}'
# → send 10.0 USDT to the wallet, then poll:
curl https://kankan.email/api/v1/orders/KK… # → {"status":"paid"}| Endpoint | Auth | What it does |
|---|---|---|
POST /api/v1/mailboxes | none | Create mailbox → address + mail_key (active instantly, free 30 days) |
POST /api/v1/mailboxes/{address}/renew | none | Create renewal order ($10/year) |
POST /api/v1/pay | none | Pay an order (xunhu = WeChat/Alipay, or usdt) |
GET /api/v1/orders/{order_no} | none | Order status; USDT orders are verified on-chain on each poll |
POST /api/v1/send | mail_key | Send email to any address (Reply-To = your address; replies return to your inbox) |
GET /api/v1/mailboxes/{address}/messages?key= | mail_key | List messages (snippet view, pagination via before_id) |
GET /api/v1/mailboxes/{address}/messages/{id}?key= | mail_key | Full message: text, html, headers |
DELETE /api/v1/mailboxes/{address}/messages/{id}?key= | mail_key | Delete a message |
Machine-readable: openapi.json · llms.txt
Verification codes & magic links
Your agent signs up for services on its own and reads OTP codes and confirmation links from its inbox — the classic email-for-AI-agent pattern.
Notifications & alerts
A durable email inbox for monitoring alerts, CI failures, cron reports and uptime pings, readable over a simple REST API — no IMAP, no parsing libraries.
Inbound task queue
Forward work orders, reports or documents to the agent's address and let it process them on its own schedule — email as an async queue for autonomous agents.
Reachable from anywhere
Anything that can send email — services, humans, other agents — can reach your agent at its @kankan.email address. Standard SMTP in, clean JSON out.
When the mailbox is created, the API returns a mail_key exactly once. We store only its SHA-256 hash. Whoever holds the key can read the mailbox — no other credential exists. Keep it in your agent's config or secrets store.
Yes. POST /api/v1/send with your mail_key sends mail to any address. It goes out via our relay with your address as Reply-To, so replies land back in your kakan inbox — a full loop.
Messages are kept 30 days, then auto-deleted. If a mailbox expires without renewal, the address is reserved for a 30-day grace period — renew within it and nothing is lost; after that the address is released.
Pass name_hint when creating — you'll get hint plus a short random suffix (e.g. openclaw-x7k2@kankan.email) so addresses can't be squatted or guessed.