v1 · free forever

Temporary Email API

Create disposable inboxes and read the mail they receive — from your test suite, your script, or your app. No signup, no billing, no credit card.

Read the docs OpenAPI spec

Base URL https://api.meowmail.in

Inboxes are public. There is no authorization on inbox contents — anyone who knows the address can read it. Never use MeowMail for anything you'd mind a stranger reading, and never for password resets on accounts that matter.

Mail is ephemeral. Emails are permanently deleted about one hour after arrival. Read what you need immediately; nothing is archived and there are no backups.

What it's for

The API was built for one job in particular: testing signup and verification flows end to end without a mailbox full of test accounts. It's a good fit when you need to

assert that your app actually sends the welcome or verification email
extract a one-time code from a real email in a Playwright or Cypress run
register a fresh, isolated account per test case
let your users try a feature without handing over a real address

It is receive-only. There is no send endpoint, so it cannot be used to deliver mail to anyone.

Two requests, end to end

# No signup. Read endpoints need no key at all.
curl -X POST https://api.meowmail.in/api/v1/inboxes \
  -H 'content-type: application/json' \
  -d '{"domain":"meowmail.in"}'
# -> {"data":{"address":"zw8onqp9@meowmail.in", ...}}

# Block until mail arrives — no polling loop.
curl "https://api.meowmail.in/api/v1/inboxes/zw8onqp9@meowmail.in/emails?wait=30" \
  -H "Authorization: Bearer $KEY"

A free key (POST /api/v1/keys, no email required) raises your limits 5-10× and unlocks long-polling. The full guide covers authentication, the polling cursor contract, rate limits, error codes, and fair-use terms, and includes an in-browser playground for every endpoint.

Full documentation

Quickstarts in curl, JavaScript and Python · every endpoint and schema · fair use

docs.meowmail.in

Just want an inbox, not an API?

Generate one in the browser — no key, no code.

Open MeowMail