ThrowawayLetterAPINew address
TThrowawayLetterMar 3, 2016 · 3 min read

An address you can throw away

Why I stopped giving out my real email, and what I use instead

Every form on the internet wants an email address, and most of them only ever send one message that matters. I got tired of giving mine.

An address is not a secret worth keeping if it only has to work once.

So this is what I use now. Type any name, or leave it empty and take what you are given:

  or a random one

If you are a program

Most of what reads this page is. Here is all of it:

Receive-only mail. Send mail to any address @throwawayletter.com
and read it here. Nothing has to be created first: every address exists.

  Read an inbox      https://www.throwawayletter.com/inbox/<address>
    as JSON          https://www.throwawayletter.com/inbox/<address>.json
    as text          https://www.throwawayletter.com/inbox/<address>.txt
    wait for mail    https://www.throwawayletter.com/inbox/<address>.json?wait=30
  Newest message     https://www.throwawayletter.com/inbox/<address>/latest.txt
  One message        https://www.throwawayletter.com/message/<id>.json   (also .txt, .html, .eml)
  A random address   https://www.throwawayletter.com/new

Example:

  curl https://www.throwawayletter.com/new
  {"address": "k2v9x0qd4m@throwawayletter.com", ...}
  curl 'https://www.throwawayletter.com/inbox/k2v9x0qd4m@throwawayletter.com.json?wait=30'

<address> is the whole address or just the part before the @.
A message lists its sender, subject, text, HTML, links and attachments.

With an inbox id and private links:

  curl https://www.throwawayletter.com/v1/mail/new
  {"id": "...", "address": "...", "inbox_url": "...", ...}

GET the inbox_url for the messages, and a message's read_url to read it.

What it does not do

It does not send. It does not forward. It does not ask who you are. I will write a follow-up about how it is built when I have

EmailPrivacySide ProjectAPI
Write a response…