Add an IMAP message source

Gmail

To add an IMAP message source for your Gmail or Google Workspace account, you need to:

  1. Be sure IMAP is enabled for your account.
  2. Create an app password.

๐Ÿ“˜

MFA Required

You must have Multi-Factor Authentication (MFA) enabled on your Google account in order to create an app password for the IMAP integration.

To enable MFA, see Turn on 2-Step Verification.

Enabling IMAP for your account

  1. Sign into your Gmail account
  2. Click Settings on the top right, then "See all settings"
  3. Click on the "Forwarding POP/IMAP Enable IMAP" sub-menu, then "Enable IMAP"
  4. Save changes

Creating an app password

  1. Login to Google account security
  2. Click "Signing into Google" then "App passwords"
  3. In "Select app" choose "Mail", and in "Select device" choose "Other" and enter "Sublime Platform"
1444
  1. Once you've created an app password, enter it into the IMAP / App Password field in Sublime when creating the IMAP message source.

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
3306
  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.

  1. 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".

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

Custom IMAP servers

๐Ÿ“˜

If your IMAP serverโ€™s capabilities include SPECIAL-USE as defined by RFC 6154, the Sublime Platform will assume that these special use folders are properly configured to adhere to the attributes on the mailbox. For example, when the SPECIAL-USE capability is enabled, Sublime will treat folders with the \All attribute as a virtual mailbox containing all incoming mail, and will not ingest mail from any other folders in that mailbox.