Integrate with Bitwarden#
Bitwarden can generate masked email addresses in Fastmail, allowing you to more easily hide your real email address when signing up for services. This guide will walk you through the process of setting up the integration. If you want more formal guides: Fastmail has a guide, primarily for creating an API token, and Bitwarden has a guide, primarily for adding the token to Bitwarden.
Create an API token#
First, login to your Fastmail account and navigate to the settings page.
Under Privacy & Security, click on Manage API tokens.
Click on New API token. You may need to enter your fastmail password to proceed. Then enter a name for the token, probably something related to Bitwarden, like Bitwarden Masked Email Integration. Make sure you select the Masked Email scope, and then click Generate API token.
Store the token securely
Make sure to copy the token and store it in a safe place. It will not be shown again, and you will need to generate a new token if you lose it. A good place could be Bitwarden itself, in your Fastmail login as a note to easily find it.
Add the token to Bitwarden#
Now that you have the API token, you can add it to Bitwarden. Unlike passwords and other sensitive information, Bitwarden cannot easily save or share the token for you. You will need to manually add it to each device and application you want to use it with. Below are instructions for adding the token to the browser extension and the desktop app. The process is similar for both, as well as for the web vault and mobile apps.
Browser Extension#
Open the Bitwarden extension, navigate to the Generator tab at the bottom, click Username, and then Forwarded email alias.
Scroll down, select the Fastmail Service and enter your API Access Token.
Saving the token
You are not done yet. The token will not be saved until you generate your first masked email address. If you close the extension without generating an email address, you will need to re-enter the token.
Scroll back up and click the Regenerate Username icon, which looks like two arrows in a circle. This will spin and then generate a new masked email address. You can now use this email address when signing up for services.
Now, when you go to Fastmail, you can see this email addresses in the Masked Email section of your settings.
You don't have to go to the generator tab each time. You can instead generate a masked email on the fly when creating a new login. Just click the generator icon next to the Username field.
Desktop App#
Open the Bitwarden desktop app, navigate to the View tab on your menu bar at the top of your screen, and click Generator. You can also use the keyboard shortcut Cmd + G on macOS.
This will open the Generator pop up window. Select Username, Forwarded email alias, and then Fastmail from the Service dropdown. Then enter your API Access Token.
Saving the token
You are not done yet. The token will not be saved until you generate your first masked email address. If you close the extension without generating an email address, you will need to re-enter the token.
At the top, click the Regenerate Username icon, which looks like two arrows in a circle. This will spin and then generate a new masked email address. You can now use this email address when signing up for services.
Now, when you go to Fastmail, you can see this email addresses in the Masked Email section of your settings.
You don't have to open the generator window each time. You can instead generate a masked email on the fly when creating a new login. Just click the generator icon next to the Username field.
