Skip to main content

​
Prerequisites

You need a Temp Mail Lab Premium account, an active API entitlement, and a scoped API key created in the dashboard. Production credentials will become available only after the approved public launch. Call the API only from a trusted backend. Do not embed a key in browser JavaScript, a mobile binary, desktop client, public repository, URL, or analytics event.
  1. Create a key with domains:read, emails:write, emails:read, and messages:read.
  2. Call GET /v1/domains and select an active domain with creation and receiving enabled.
  3. Call POST /v1/emails once with a unique Idempotency-Key.
  4. Store the returned opaque email ID and address.
  5. Send mail to that address from the system you are testing.
  6. List messages at a conservative interval and stop after a fixed deadline.
  7. Fetch only the message body, source, or attachment your workflow needs.

Run the quickstart

Follow a minimal cURL flow.

Review authentication

Choose scopes and handle keys safely.
The API never waits in the background for a message. Your integration owns its retry cadence, jitter, and final deadline.
Last modified on August 2, 2026