Add an IMAP message source

Gmail

With MFA enabled on your Gmail account

If you have MFA enabled on your Gmail account, you must use an app password instead of your normal login password.

1. Enable IMAP in Gmail

Settings —> See all settings —> Forwarding POP/IMAP Enable IMAP -> Enable IMAP -> Save changes

2. Generate app password

  1. Navigate to Google account security -> Signing into Google -> App passwords
  2. In "Select app" choose "Mail", and in "Select device" choose "Other" and enter "Sublime Platform"

3. Enter your app password in Sublime to complete IMAP setup

Without MFA enabled on your Gmail account

If you don't have MFA enabled (not recommended), follow these steps.

  1. Enable IMAP in Gmail
    Settings —> See all settings —> Forwarding POP/IMAP Enable IMAP -> Enable IMAP -> Save changes

  2. Enable "less secure" app access
    Navigate to Google account security -> Scroll to Less secure app access -> Turn ON access

  3. Enter your regular email login credentials into Sublime to complete IMAP setup

Microsoft 365

To add an IMAP message source for your Microsoft 365 account, you need to:

  1. Be sure IMAP is enabled for your account
  2. Create an app password, if and only if you're using two-step verification with your Microsoft 365 account,

Enabling IMAP for your account

📘

Microsoft 365 administrator required

You'll need to be a Microsoft 365 administrator to follow these steps. If you're not a Microsoft 365 administrator, we recommend skipping this step, attempting to add the message source, and reaching out to your Microsoft 365 administrator for assistance if you receive a signin error when attempting to add the message source.

  1. Sign into the Microsoft 365 admin center at https://admin.microsoft.com
  2. In the lefthand menu, go to Users > Active Users
  3. Search for your user and click the matching row
  4. In the righthand drawer that opens up, click the Mail tab
  5. Under Email apps, click Manage email apps
  1. Check the box next to IMAP and click the Save changes button

Creating an app password

📘

You only need to create an app password if you're using two-step verification with your Microsoft 365 account.

To create an app password for your Sublime IMAP message source, follow Microsoft's guide here. You can give your app password any name in Microsoft 365, for example, "Sublime Platform IMAP message source".

Once you've created an app password, enter it into the IMAP / App Password field in Sublime when creating the IMAP message source.