InboxFlick / docs

FREE · NO ACCOUNT · RECEIVE ONLY

Temp Mail APIA small inbox.
A simple API.

Create a temporary email address, receive messages, and test your email flows. Free access, no API key, and a private inbox for every session.

10 minutes to start · Extend up to 60 minutes · JSON over HTTPS

terminal / quickstart.sh
# Requires curl and jq. Keep the jar private.
umask 077
JAR=$(mktemp)
API="https://inboxflick.com/v1"

# Create an inbox and save its possession cookie
MAILBOX=$(curl --fail-with-body -sS -c "$JAR" \
  -H 'Content-Type: application/json' \
  -d '{}' "$API/mailboxes")
ID=$(printf '%s' "$MAILBOX" | jq -er '.data.mailbox.id')
printf '%s\n' "$MAILBOX" | jq '.data.mailbox'

# Select it, preserving both cookies
curl --fail-with-body -sS -b "$JAR" -c "$JAR" \
  -X POST "$API/mailboxes/$ID/select"

# Send a test email from your own mail provider,
# then read the inbox (poll every 5 seconds or slower)
curl --fail-with-body -sS -b "$JAR" "$API/messages"

# When finished: destroy the inbox, then remove the jar
# curl --fail-with-body -sS -b "$JAR" -c "$JAR" \
#   -X DELETE "$API/mailboxes/current"
# rm -f "$JAR"

FROM REQUEST TO INBOX

Five steps. One private session.

The same receiving service as the InboxFlick website, ready for your scripts.

  1. 01

    Create

    Get a random address and save the secure cookie.

  2. 02

    Select

    Choose the new inbox with the same cookie jar.

  3. 03

    Receive

    Send a test message from your own provider.

  4. 04

    Read

    List messages, then fetch a message by ID.

  5. 05

    Clean up

    Delete the inbox when your test is finished.

Run your first request →

FREE BY DEFAULT

Useful access.
Clear limits.

No subscription or API key is required. Fair-use limits keep the shared service available.

Read the usage policy →
Request rate
8 / second per IP, shared across free endpoints
Mailbox creation
5 / minute also 10 / hour · 20 / day per IP
Active inboxes
5 per IP shared with web usage
Inbox lifetime
10 → 60 min extend before expiry; no recovery

BUILD WITH INBOXFLICK

Everything you need to connect.

Search documentation

Temp Mail APIFree temporary email API for development and short-lived workflows. Create private inboxes, receive messages, and clean up with a cookie-aware client.AuthenticationNo account, password, or API key. Keep a private cookie jar for each independent client.Error handlingUse the HTTP status and stable error.code. Responses contain a request_id for support.DomainsDiscover the receiving domains configured for free temporary inboxes.MailboxesCreate and manage a short-lived inbox using its private possession cookies.MessagesList, read, and delete messages inside the selected inbox. IDs never grant access by themselves.Real-time eventsReceive message.received notifications through an authenticated server-sent event stream.IntegrationsKeep cookies between requests. Run one isolated session per independent test workflow.About & usage policyInboxFlick’s free API exposes its own temporary receiving service. It does not proxy Mail.tm.