Fusspawn Temp Mail API

Quick Start

curl -X POST https://tmpmail.fusspawn.uk/accounts \
  -H "content-type: application/json" \
  -d '{"address":"demo@fusspawn.uk","password":"change-me-strong"}'

TOKEN=$(curl -s -X POST https://tmpmail.fusspawn.uk/token \
  -H "content-type: application/json" \
  -d '{"address":"demo@fusspawn.uk","password":"change-me-strong"}' | jq -r .token)

curl https://tmpmail.fusspawn.uk/messages \
  -H "authorization: Bearer $TOKEN"

Endpoints

GET/health

Service health check.

GET/domains

List available mailbox domains.

POST/accounts

Create a mailbox using address and password.

POST/token

Exchange mailbox credentials for a bearer token.

GET/me

Return the authenticated mailbox account.

GET/messages

List messages for the authenticated mailbox.

GET/messages/:id

Read one stored message and mark it seen.

GET/messages/:id/source

Download the raw RFC 822 email source.

DELETE/messages/:id

Delete a stored message and raw source.

Account Request

{
  "address": "demo@fusspawn.uk",
  "password": "change-me-strong"
}

Message Flow

Email Routing should send inbound mail to this Worker. The Worker forwards every inbound email to the configured Gmail address. If the recipient address exists as a temp-mail account, it also stores metadata in D1 and the raw message in R2.

This service is receive-only. It does not send replies from fusspawn.uk.