API tokens

API tokens are developer keys used to access your account's information for integrations. API tokens are available to users on Standard or Professional subscription plans.

An API token grants access to your account's information. Treat your API token like an app password: only select the level of access that you need, and do not give an API token to anybody you do not trust.

Creating an API token

To create an API token:

  1. Open the Settings → Password & Security screen. Find the API tokens section and click Manage.
  2. Enter your password and click Unlock, then click New API token.
  3. Enter a name to identify this API token. (Make sure it's something you will be able to read and understand in the future, in case you need to review or revoke access.)
  4. Select whether your API token should have read-only access, and the level of access your API token is granted.
  5. Click Generate Password.

The next page will display your new API token. Copy and paste the token into a safe place before you click the Done button in your Fastmail settings, as you will not be able to see it again.

Reviewing and removing API tokens

You can review an API token's access details at any time, which include the following:

  • What the API token has access to
  • The date and time access was first given
  • The date and time of most recent access

To review an app password's access details:

  1. Open the Settings → Password & Security screen. Find the API tokens section and click Manage.
  2. Enter your password and click Unlock.
  3. Find your device in the API tokens list and click Review access

You can remove an API token at any time if you no longer use or trust an app, or if you lose your device. This can be done by going to the Review access screen, then clicking Remove access.

Where can I learn more about using API tokens?

If you're interested in learning more about writing integrations with Fastmail, a great place to start is reading our developer documentation.

API token integrations

Was this article helpful?
0 out of 0 found this helpful