A longer description of the purpose of this connection
Specifies the protocol to use when connecting the service. Values are:
Microsoft OAuth2 (coming soon in version 8.1.1)
This is a new attribute that is used when OAuth2 authorization is activated. It selects theOAuth2 Client Credentialto be used when connecting this service.
The hostname or IP addresses of the IMAP or POP3 server
Optional, if not specified, we use the default ports. Leave blank or 0 for default (for POP3 plain: 110, SSL/TLS: 995; for IMAP plain:143, SSL/TLS: 993).
The period in minutes the mail accounts are connected to mailboxes.
IMAP or POP3 connection timeout in milliseconds, valid value: 1-30000 ms. Leave blank or 0 for default (30000 ms).
The Folder in the mailbox from which the emails will be downloaded. If left blank, emails are loaded from the INBOX folder.
The Folder attribute is only used when the protocol is IMAP.
Decide what to do after Emails are downloaded
SINCE VERSION 8.1.1
By default (and up to version 8.1.1) Mail Accounts mark downloaded emails as "seen" (i.e. "read") in the mailboxes. Since version 8.1.1 administrators may configure mail accounts to remove messages from the mailboxes after they have been successfully downloaded
Best practice for large mailboxes
If you are using Microsoft Exchange, you can create a rule to directly copy each incoming mail into a separate folder (e.g. “Jira Archive”). Instead of using the setting “Mark messages as seen”, set the After download function in the Incoming Mail Accounts to the “Delete messages” option. This way the inbox is kept clean and empty, but you still have a copy of all your emails. Processing time in large mailboxes is reduced to seconds instead of minutes with this little workaround.
It is possible to test the connection before actually saving the connection itself, it is also highly recommended to do so in order to check if there are any errors in the configuration.
Please note that we highly recommend keeping the inbox only be accessible by the app and not manually by users. If any users read the emails from the inbox before we get to process them (and they will be marked "read") we will not be able to process the emails.