Command reference
HappyMail Guide
Last updated: June 28, 2026
HappyMail creates owned disposable inboxes on happymail.work
and delivers incoming email into Discord threads. It is built for signup
verification, testing, and accounts where you want an address you can mute,
delete, block, or optionally submit mail from when outbound mail is enabled.
Quick Start
- Invite HappyMail to the Discord server.
- Run
/mail_setup create_forumonce to create the mailbox forum. - Run
/temp nameto createname@happymail.work. - Use that email address on the website or app you are testing.
- Read incoming messages in the thread HappyMail creates for that inbox.
- If outbound mail is enabled, use
/send_emailinside that thread or the Reply button on a received message.
How It Works
- Alias
- The local part of an email address. Creating
applegives youapple@happymail.work. - Owner
- The Discord user who created the alias. Other users cannot claim, delete, mute, or manage that alias.
- Thread
- Each alias gets a Discord thread or forum post where received email is posted.
- Deleted alias
- The name stays reserved to the original owner, but future mail to that address is dropped.
Commands
/help
Shows a short Discord-native guide. The command supports English, Traditional Chinese, Japanese, French, Spanish, German, Portuguese, and Korean.
| Option | language, optional. Defaults to English. |
|---|---|
| Visible to | Everyone. |
/mail_setup
Configures where HappyMail creates inbox threads for this Discord server.
| Option | mode: create_forum creates a new forum, use_current uses the current text or forum channel. |
|---|---|
| Visible to | Server managers. |
| Example | /mail_setup create_forum |
/temp
Creates or reactivates an owned disposable inbox.
| Options | name, required. note, optional private note. |
|---|---|
| Allowed names | Letters, numbers, dots, underscores, and dashes. |
| Example | /temp github creates github@happymail.work. |
/temp_random
Creates an owned disposable inbox with a random suffix. Use this when you want a harder-to-guess address for signups.
| Options | prefix, optional label. note, optional private note. |
|---|---|
| Example | /temp_random prefix:github creates an address like github-k7m2q9az@happymail.work. |
/temps
Lists recent aliases, their status, message count, last received time, and thread link.
| Option | show_all, optional. Managers can list aliases owned by everyone. |
|---|---|
| Visible to | Everyone for their own aliases; managers for all aliases. |
/send_email
Submits an email from the alias represented by the current Discord thread. This command works only when outbound SMTP is configured by the operator.
| Options | receiver, required. content, required. subject, optional. |
|---|---|
| Visible to | The alias owner and server managers. |
| Example | /send_email receiver:person@example.com content:"Hello from this alias" |
/temp_mute
Stops Discord posting for an alias while still storing received mail metadata and previews.
| Option | name, required. Alias name or full email address. |
|---|---|
| Example | /temp_mute github |
/temp_unmute
Resumes Discord delivery for a muted alias.
| Option | name, required. Alias name or full email address. |
|---|---|
| Example | /temp_unmute github |
/temp_delete
Deletes an alias so future mail is dropped. The alias remains reserved and cannot be taken by another user.
| Option | name, required. Alias name or full email address. |
|---|---|
| Example | /temp_delete github |
/mail_stats
Shows service counts such as server count, active aliases, stored messages, spam, blocked mail, and active block rules.
| Visible to | Server managers. |
|---|
Spam Controls
/block
Adds a block or spam rule for a sender, sender domain, or keyword.
| Options | value, required. scope, required. reason, optional. |
|---|---|
| Sender | /block spammer@example.com scope:this_thread |
| Domain | /block example.org scope:this_thread |
| Keyword | /block "limited time offer" scope:this_thread |
/unblock
Disables an active block rule.
| Options | value, required. scope, required. |
|---|---|
| Example | /unblock example.org scope:this_thread |
/blocks
Lists active block rules. Inside an alias thread, normal users see rules for that alias. Managers can see global rules.
Scopes
this_thread- Applies only to the alias represented by the current thread. Use this for normal per-inbox spam cleanup.
global- Applies everywhere. Only managers can create or remove global rules.
Permissions
| Everyone | /help, /temp, /temps, inbox mute/unmute/delete for aliases they own, outbound submission for aliases they own when enabled, and per-thread block rules. |
|---|---|
| Managers | /mail_setup, /mail_stats, global block rules, and manager-only /temps show_all. |
| Alias owners | Only the creator can manage an alias unless a manager overrides it. |
Email Format In Discord
HappyMail posts each email as a compact embed so inbox threads stay readable.
- Subject is shown as the message title.
- Sender, recipient, and message size are shown as metadata.
- Likely verification codes are highlighted.
- The first links are shown as numbered links and buttons.
- Action buttons can reply, block the sender, block the sender domain, mark spam, mute the alias, or delete the alias.
- Attachments are not downloaded; only attachment names are shown when present.
- Email text is clipped to keep Discord threads compact.