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.
- 01
Create
Get a random address and save the secure cookie.
- 02
Select
Choose the new inbox with the same cookie jar.
- 03
Receive
Send a test message from your own provider.
- 04
Read
List messages, then fetch a message by ID.
- 05
Clean up
Delete the inbox when your test is finished.
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