Quickstart

Set your server-side credentials

export TML_API_KEY="tml_live_replace_with_your_key"
export TML_API_BASE="https://api.tempmaillab.com"

Never put an API key in browser code, a mobile binary, a public repository, or logs.

Create an email

curl --fail-with-body \
  --request POST \
  --header "Authorization: Bearer $TML_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: checkout-run-20260801-0001" \
  --data '{}' \
  "$TML_API_BASE/v1/emails"

Store data.id and data.address. The address receives independently of the Temp Mail Lab website, dashboard, or a browser session.

Read messages

curl --fail-with-body \
  --header "Authorization: Bearer $TML_API_KEY" \
  "$TML_API_BASE/v1/emails/$EMAIL_ID/messages?limit=20"

Your application controls every request. Stop checking after your workflow deadline and honor 429 plus Retry-After.

Prefer an API client? Download the maintained Postman collection.

Last modified on August 8, 2026

⌘I

Getting started

Core concepts

Requests and reliability

Resources

Set your server-side credentials

Create an email

Read messages

​Set your server-side credentials

​Create an email

​Read messages

Set your server-side credentials

Create an email

Read messages