Skip to content
TempMailHush Docs

TempMailHush API Documentation

Build email verification tests with disposable inboxes you can create, poll, and delete from code.
Get startedOpen the app

What the API is for

Section titled “What the API is for”

Use the TempMailHush API when a test, script, CI job, or agent needs a real temporary email address and a readable inbox. The API is receive-only and built for short-lived verification workflows, not permanent account recovery.

Typical workflow

Section titled “Typical workflow”
  1. Create a mailbox with an API key.
  2. Use the generated address in a signup, onboarding, trial, password-reset test, or QA flow.
  3. Poll the mailbox until the verification email arrives.
  4. Read the message body, HTML preview, raw source, or attachments.
  5. Delete the mailbox or let it expire.

Base URL

Section titled “Base URL”
https://tempmailhush.com/api/v1

Safety boundary

Section titled “Safety boundary”

Temporary email is useful for low-risk receiving. Do not use temporary mailboxes for banking, healthcare, government accounts, production recovery addresses, billing contacts, or accounts that need long-term access.