All guides

Creating a Fastmail API token

Connect the app to Fastmail with a token limited to Masked Email access.

Check your plan first

Fastmail does not issue API tokens on Basic, the entry business plan. Masked Email still works there from Fastmail's own settings, but there is no token to paste into the app. Every other plan can create one, personal and business alike, so this only bites if you are on Basic.

In Fastmail

  1. Open app.fastmail.com/settings/security/tokens, under Settings then Privacy & Security.
  2. Create a new API token and name it something you will recognise later.
  3. Give it the Masked Email scope and nothing else.
  4. Copy the token. Fastmail shows it once.
Fastmail's new API token form with the Masked Email scope selected and the other scopes cleared.
Select Masked Email and leave the other scopes off before generating the token.

In the app

  1. Open Settings.
  2. Paste the token into the Fastmail API Token field and save.

The app checks the token with Fastmail immediately. If it reports that the Masked Email scope is missing, create a new token. Fastmail does not let you add a scope to an existing token.

Masked Email Manager showing a demo list after a successful connection.
Once the token is accepted, the app loads the Masked Email list. This is the app's safe demo data.

Revoking it

Delete the token on that same Fastmail page. The app stops working at once and there is nothing else to clean up on the device. Revoke it when you sell the phone or stop using the app.

That token is the only setup Masked Email Manager needs. Paste it in and your addresses appear.

Keep reading

Updated