Incoming Mail Connections

To use mail handlers and process your incoming emails to create or modify issues, incoming Mail Accounts have to be configured first.
Due to security reasons, the Email This Issue add-on cannot access the mail servers in Jira itself, so mail accounts should be configured within Email This Issue's Administration interface.
1. Go to the Administration configuration tab, and choose Mail Accounts under the INCOMING MAILS menu item.
Incoming Mail Connections
2. To create a new Mail Account, click on Add.
3. Email This Issue supports login and OAuth authentication mechanisms for Mail Accounts. In the Add Mail Account dialog, select the correct protocol:
  • POP3, IMAP: log in with username and password
  • OAuth for Gmail/Gsuite: OAuth2
  • OAuth2 for Microsoft 365
Note: the content of the dialog changes based on the authentication method you select.
In case of an unsuccessful connection in the Incoming Mail Connection, the status becomes red and a protocol log becomes available:
Incoming Mail Connections - Protocol log
The Protocol Log is displayed only when the status is red (indicating a problem with the connection) and it contains information about the errors that occurred during fetching e.g. authentication failed, wrong hostname etc.


Currently Email This Issue does not delete processed emails. Before saving the Mail Account, please use the "Test Connection" button to check if Email This Issue is able to connect to your mailbox.
After creating Mail Accounts, go to Mail Handlers to configure the actions that should be executed when processing new emails.
If you’re working on a production account that already has emails in the inbox (read or unread), remove everything you don’t want to be processed. This is needed because at the first processing round we download every email from the target folder. Later on, we only download those that have not been processed yet.

OAuth 2.0 Settings

OAuth authentication is currently supported for both Google and Microsoft 365 accounts.
If you want to use OAuth 2.0 authentication, select this option with the appropriate protocol. A new dropdown list and button will appear under the protocol selector.

OAuth 2.0 Settings for Google

  1. 1.
    Select the Client Credentials you created on the credentials page.
  2. 2.
    Enter the user name to the SMTP Server you want to use.
  3. 3.
    Click on the "Authorize with Google" button to grant access to Email This Issue to send emails from your account.
  4. 4.
    In the dialog, select the account which belongs to the email address you use for login:
    Note: If you have multiple Google accounts select the one with the email that matches the username in the SMTP Server dialog. Emails will be sent from that account.
  5. 5.
    If you get the following warning, do the following:
    1. 1.
      Click Advanced.
    2. 2.
      Click the "Go to (unsafe)" link.
    3. 3.
      Confirm your choice by clicking Allow.
Result: You can send emails in Email This Issue from Gsuite with OAuth Authentication.
If you want to revoke the access from Email This Issue to your Gmail account, you can do it by visiting Account Settings.
Important. Starting from June 15, 2020 Less Secure Apps is not be supported in GSuite. Read more at:
Authentication should be done using OAuth2.

Shared mailbox settings

A shared mailbox is a mailbox that multiple users can use to read and send e-mail messages. You can read more about them here:
To use a shared mailbox you just have to enter the username and password (or use OAuth) of the account you want to log in with, then enable the "Use a shared mailbox" option and enter the alias of the shared mailbox in the field that appears:
Shared mailbox settings for Incoming Mail Connection