The Internet Message Access Protocol (IMAP) is a standard mail protocol that stores email messages on a remote server but allows Users to view and manipulate them as if they were stored locally on their computer or device. There will be records of sent items and support for nesting of folders within the inbox (depending upon the provider, for Gmail does not support this while Outlook.com does support it).
If you configured a version of Outlook installed on your computer then you likely have all of the details that are required:
- Port (nearly always 993)
- Email Address of the account to retrieve mails for
- Password for that account (see notes further down about this)
If not, then you should be able to get them from your mail provider.
One common examples is Gmail:
- Click the "settings" cog near the top right of the screen and then See all settings
- Click Forwarding and POP/IMAP
- In the IMAP access section, ensure that Enable IMAP is selected
- Click Save Changes
- Click on Configuration instructions in the IMAP access section and you will be taken to a page that shows the Incoming Mail (IMAP) Server with the host that you require and confirmation of the port number
- The Email Address that you will enter into the Curiosity connector configuration screen will be the email address of your Gmail account
- The Password may be the password that you use to log into your Gmail account online or, if 2-Step Verification is enabled, then you will need to configure an App Password as described in the Google support document "Sign in with App Passwords"
Another common example is Hotmail / Outlook.com:
- Click the "settings" cog near the top right of the screen and then View all Outlook settings
- Click Sync email
- Under IMAP setting, there be a server name value, which is the host that is required to configure the connector and it will show the port
Creating an IMAP Connector in Curiosity
Click the menu button at the top right of the Curiosity application, then Connect Sources, then IMAP Mailbox. Within the popup that appears, click + Add.
You may wish to change the Name of the connector to relate to the account that you are importing (eg. Dan @ Curiosity IMAP Task), likewise for the Source (which will make it easier to filter email results based upon which connector, and so which email account, the mails came from).
- Enter the Host (aka. Server Name) value
- Change the Port if 993 is not the appropriate value (which is unusual)
- Enter the Email Address
- Enter the Password
The default schedule (as specified by the Cron value) is to run the import at 1am every night but you can change this (and find out more information about initiating a one-off import manually and viewing the import logs by reading the "Scheduled Tasks" article).
(Warning: Some IMAP providers limit the bandwidth that you can consume in any one day. For example, Google state that to "avoid temporarily locking yourself out of your account, make sure you don't exceed 2500 MB per day for IMAP downloads". If you have more data that this in your account then the connector will not run to completion the first time but it will try to pick up where it left off next time that it runs and so hopefully all of the mails will eventually be imported.)
Unless you change the Permissions settings, all imported emails will be visible to every User of the Curiosity system. To change this, click on the Edit button alongside the Permissions label:
To change the import from making all emails imported by the connector accessible to everyone, change the toggle from Public Access to Restricted Access. This will reveal a search area where you may select one or more Users and or Team that will be granted access.
If you change your mind and wish to return to importing as public then switch the toggle back to Public Access.
Click Save to close the permissions popup.
If you have selected specific User(s) and / or Team(s) then they will now be listed alongside the Edit button by permissions.
Click Save to complete configuring the connector.
Either wait until the specified schedule that the connector is configured to run at or click the Play button now to import the emails that are currently available through the IMAP connection.