Skip to content

CLI command

tinbox create-disposable-mailbox

Aliases: mktmp

Mint a throwaway email address and a pollToken to read its mail with poll_disposable_mailbox. Ideal for grabbing a one-time code (OTP) without touching a real inbox. By default the ADDRESS is kept (a catch-all keeps routing its mail) and the TOKEN never expires — pass expiresIn (e.g. '2h', '30m', '7d') to expire the token, and expireAddress:true to also tear the address down at that time.

Generated from tool: create_disposable_mailbox

Usage

sh
tinbox create-disposable-mailbox --expiresIn <expiresIn> [--expireAddress] --label <label>

Flags

NameTypeRequiredDefaultDescription
--expiresInstringyes—Friendly token lifetime, e.g. '2h', '30m', '90s', '7d', '1h30m'. Omit ⇒ the pollToken never expires. Clamped to 5min–30d.
--expireAddressbooleanno—If true, the ADDRESS is destroyed when the token expires (only meaningful with expiresIn). Default false: keep the address — the catch-all route keeps mail flowing.
--labelstringyes—Optional human label, e.g. 'acme-signup' — shown in the mailbox list.