Web UI Guide

Overview

The OneShotMail web UI is available at app.oneshotemail.com. It provides a visual interface for managing your email addresses, reading received emails, composing sends, and viewing account usage.

The web UI uses the exact same API as the CLI and SDKs. There are no special backend endpoints — it is a pure single-page application that talks to the public API.

Authentication

1. Open app.oneshotemail.com.
2. Enter your API key.
3. Your key is stored in browser memory (not localStorage) for security. The session ends when you close the tab.

If you do not have an API key yet, register at the queue page to get one.

Dashboard

The dashboard shows:

• Current plan and billing cycle dates.
• Usage meters — visual bars showing receive and send usage against your monthly allocation.
• Credits remaining — your available credit balance.
• Quick-create button — one click to create a new receive address.
• Recent addresses — a live-updating table of your addresses with current status.

The address table shows:

• Address ID (truncated, click to copy full address).
• Mode (receive or send).
• Status with colour coding (green = received, yellow = waiting, red = expired, blue = sent).
• Label.
• Created time and time until expiry.

Creating addresses

Receive address

1. Click the New Address button.
2. Set the TTL (time-to-live) using the dropdown or enter a custom value.
3. Optionally set a label.
4. Click Create.
5. The new address appears at the top of the address table with status “waiting”.
6. Copy the full email address to your clipboard with the copy button.

Send address (compose and send)

1. Click the Compose button.
2. Fill in the compose form:
   • To: Destination email address.
   • Subject: Email subject line.
   • Body: Rich text editor with plain text and HTML toggle.
   • Attachments: Drag and drop or click to upload files.
3. Click Send.
4. The send address appears in your address table with status “sent”.

Email viewer

Click on any address with status “received” to open the email viewer.

View modes

• Rendered HTML — The HTML body rendered in a sandboxed frame with inline images displayed.
• Plain text — The plain text body.
• Raw source — The complete RFC 822 email source, including all headers (DKIM, SPF, DMARC).

Attachments

• Each attachment shows its filename, MIME type, and size.
• Click Download to save an individual attachment.
• Click Download All to get a zip file of all attachments.
• Image attachments show inline previews.

Actions

• Copy — Copy email content (subject, body, or headers) to clipboard.
• Delete — Delete the address and all email data immediately.

Address management

Filtering

Use the filter bar above the address table:

• Status filter — Show only waiting, received, expired, or sent addresses.
• Mode filter — Show only receive or send addresses.
• Label filter — Filter by label (exact match or prefix).
• Date range — Filter by creation date.

Bulk operations

• Delete by label — Enter a label and delete all matching addresses at once.

Account settings

Access from the gear icon in the top-right corner.

• API key — View your key prefix, regenerate your key (with confirmation dialog).
• Plan and billing — View your current plan and click through to the Stripe customer portal for plan changes.
• Buy credits — Select a credit pack and complete purchase via Stripe Checkout.
• Usage history — View a table of your usage events with CSV export.

Keyboard shortcuts

Key	Action
N	New address (receive).
C	Compose (send).
R	Refresh the address table.
/	Focus the search/filter bar.
Esc	Close the email viewer.
D	Delete selected address.

Queue status (unauthenticated)

If you are waiting for free tier approval, visit app.oneshotemail.com/queue to see:

• Your queue position.
• Estimated wait time.
• Status updates.