CLI to create Fastmail Masked Emails for whenever you need to
go get github.com/dvcrn/maskedemail-cli
or newer Go versions
go install github.com/dvcrn/maskedemail-cli@latest
You'll need to create a FastMail API token.
🔒 The only necessary scope is "Masked Email".
Always use unique API tokens with the minimum scope(s) necessary for different purposes.
You can test authentication by running maskedemail-cli -token abcdef12345 session.
Usage of maskedemail-cli:
Flags:
-accountid string
fastmail account id (or MASKEDEMAIL_ACCOUNTID env)
-appname string
the appname to identify the creator (or MASKEDEMAIL_APPNAME env) (default: maskedemail-cli)
-token string
the token to authenticate with (or MASKEDEMAIL_TOKEN env)
Commands:
maskedemail-cli create [-domain "<domain>"] [-desc "<description>"] [-prefix "<prefix>"] [-enabled=true|false (default true)]
maskedemail-cli list [-show-deleted] [-all-fields]
maskedemail-cli enable <maskedemail>
maskedemail-cli disable <maskedemail>
maskedemail-cli delete <maskedemail>
maskedemail-cli update <maskedemail> [-domain "<domain>"] [-desc "<description>"]
maskedemail-cli session
maskedemail-cli version
Example:
$ maskedemail-cli -token abcdef12345 create -domain "facebook.com" -desc "Facebook"
$ maskedemail-cli -token abcdef12345 enable [email protected]
$ maskedemail-cli -token abcdef12345 disable [email protected]
$ maskedemail-cli -token abcdef12345 list
Masked Email For Domain Description State
[email protected] facebook.com Facebook disabled
Note that these are based on an earlier version of the CLI.
- Siri Shortcut to disable the masked email of the currently selected message in Apple Mail on macOS
- maskedemail-js: Node package ready to import, backed by this CLI compiled to wasm
- Masked Email Manager iOS App: iOS App backed by this CLI compiled to GopherJS
MIT
JMAP API documentation from jmapio/jmap (Apache 2.0 / Copyright 2016 Fastmail Pty Ltd)