Email This Issue
📈 Marketplace❓ Support❤️ Feedback🏠 META-INF Apps
Email This Issue - for Jira Cloud
Email This Issue - for Jira Cloud
  • ⬇️Overview
  • Email This Issue - for Jira Cloud
  • Features
  • How Email This Issue Works
  • Secure the email channel with Email This Issue
  • Comparing Email This Issue and Jira Cloud
  • 📤Outgoing Emails
    • Outgoing emails overview
    • Manual emails
      • Configuring manual emails
      • Sending manual emails
    • Email notification schemes and email notifications
    • Workflow post functions
    • Advanced email configuration
    • Customizing email templates
    • Canned Responses (default messages)
    • Scope evaluation
  • 📥Incoming Emails (Mail Handlers)
    • Incoming emails overview
  • Mail handlers - adding / editing
    • General handler settings
    • Filtering
    • Finding issues
    • Setting up rules and actions in the actions editor
      • Adding/editing actions
      • Adding recipients to Request Participants
      • Creating an issue
      • Updating an issue
      • Setting field values
      • Adding comments
      • Sending auto-reply emails
      • Executing workflow transitions
      • Creating a customer
      • Using split regexp
      • Conditions
      • Approve request
      • Decline request
    • Maintaining email chains
    • Mail Handler New UI
  • Global Sender Address Filters
  • Attachment Filters
    • Regular Attachment Handling Deprecation
  • 🤓Administration
    • Outgoing Mail Connections
    • Alerting via Webhooks
      • Webhooks
        • Configuring Slack to receive alerts via webhooks
        • Configuring OpsGenie to Receive alerts via webhooks
        • Configuring Microsoft Teams to receive alerts via webhooks
      • Webhook execution logs
    • Mail Queue
    • Email Audit Log
    • Permissions
    • Recipient Restrictions
    • Incoming Mail Connections
    • Email Security
    • Incoming Mail Queue
    • Incoming Mail Log
    • OAuth2 Credentials
      • Enabling OAuth2 Authorization in your Google Account
      • Enabling OAuth2 Authorization in your Microsoft 365 Account
      • Troubleshooting guides for Microsoft OAuth2 Connections
        • How to fix "BAD User is authenticated but not connected" error​
        • How to fix "401 Unauthorized" error
        • How to fix "key expires_in " error
        • How to fix "Need admin approval" error
  • ☁️Server to Cloud Migration
    • 🛫Server to Cloud - Automatic Migration tool
      • Preparing for the migration
      • Doing the migration
      • Finalizing the migration in Cloud
      • Migration with unsupported Jira versions causes errors
    • Server to Cloud - Manual migration guide for Email This Issue
  • ❓FAQ
    • No recipients error in outgoing emails
    • How-to add custom macro to email Template?
    • Why cannot I select custom event types in notification?
    • How to configure the Email This Issue addon user in Jira Cloud?
    • I get an error: Could not create request on behalf of the sender
    • Why is the Incoming Mail Queue size limited?
    • Outgoing mail not sent - Read timeout error
    • Access restriction icon is not appearing when adding internal attachments via Email this Issue
  • 🌪️General
    • Release Notes
    • API
      • API for Velocity Context Objects - 1.7
      • API for Velocity Context Objects
    • Addon Pages
      • Integrity Check
      • Feedback and Support
    • Security Advisories
      • Email This Issue Security Advisory September 28, 2020
    • Appendix
      • Supported Time Zones
    • Integration of Glass Documentation
Powered by GitBook
On this page
  • Filtering the list
  • Default Outgoing Mail Connection
  • Outgoing Mail Connections dialog
  • Login
  • OAuth 2.0 settings
  • Microsoft OAuth 2.0 host settings
  • OAuth Settings for Google
  • Shared mailbox settings
  • Testing Outgoing Mail Connection
  • Sending a test email

Was this helpful?

  1. Administration

Outgoing Mail Connections

PreviousRegular Attachment Handling DeprecationNextAlerting via Webhooks

Last updated 1 year ago

Was this helpful?

Unlike Jira, Email This Issue supports the use of multiple Outgoing Mail Connections. To access the list of Outgoing Mail Connections, go to the Administration configuration tab and choose Outgoing Mail Connections under the OUTGOING MAILS menu item.

Filtering the list

The Outgoing Mail Connection list can be filtered by clicking on the Search button. After clicking, a free text field will be opened, in which the search term can be entered. The filter searches in the Name, Description, Host, and Username fields.

Default Outgoing Mail Connection

One of the Outgoing Mail Connections can be marked as Default. Unless you define to use another Outgoing Mail Connection, the Default Outgoing Mail Connection is used for sending the emails.

Outgoing Mail Connections dialog

Email This Issue supports login and OAuth authentication mechanisms for Outgoing Mail Connections. You can select it by selecting the correct protocol:

  • SMTP: log in with username and password

  • Google OAuth2: OAuth for Gmail/Gsuite

  • Microsoft 365 SMTP (w/ OAuth2): OAuth for Microsoft account using smtp protocol

  • Microsoft 365 Graph API (w/ OAuth2): OAuth for Microsoft account using Graph API

The content of the dialog changes based on the authentication method you select.

Login

Plain Outgoing Mail Connection with optional SSL/STARTTLS encryption. If your Outgoing Mail Connection requires encryption and authentication, you can fill in the following fields.

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.

Microsoft OAuth 2.0 host settings

For OAuth2-based Microsoft365 SMTP connections, the hostname "smtp.office365.com" is used by default, when connecting to the mail server. However, in certain scenarios, the use of a custom hostname might be required. In such cases, there is a possibility to override the default value by enabling the respective "Override default host setting" toggle and selecting the desired host from the "Host" dropdown appearing below.

The dropdown contains a pre-defined set of hostnames, which are globally available. If you have even more specific needs, please contact our support team.

OAuth Settings for Google

  1. Select the Client Credentials you created on the credentials page.

  2. Enter the user name of the Outgoing Mail Connection you want to use.

  3. Click on the "Authorize with Google" button to grant access to Email This Issue to send emails from your account.

    1. Click Advanced.

Result: You can send emails in Email This Issue from Gsuite with OAuth Authentication.

Gsuite warning

Please note that starting from 2020 June 15, Less Secure Apps will not be supported in GSuite:

Authentication should be done using OAuth2

Shared mailbox settings

To use a shared mailbox you just have to enter the email address of the shared mailbox into the From Address field then proceed with the settings as if it was a normal mail account. For the username and password fields (or for the OAuth authorization) use the credentials of the account you want to log in with.

Testing Outgoing Mail Connection

While adding or editing an Outgoing Mail Connection, test if the connection details are correct.

Sending a test email

To check whether the Outgoing Mail Connection is capable of sending out emails to a certain email address, use the Send Test Email function. You can access the Send Test Email dialog by clicking the three dots next to an Outgoing Mail Connection.

You can define the Outgoing Mail Connections to use for different projects, type or issues by creating an with the proper scope.

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 Outgoing Mail Connection dialog. Emails will be sent from that account.

If you get the following warning, do the following:

Click the "Go to (unsafe)" link.

Confirm your choice by clicking Allow.

If you want to revoke the access from Email This Issue to your Gmail account, you can do it by visiting .

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:

🤓
Advanced Email Configuration
Account Settings
https://gsuiteupdates.googleblog.com/2019/12/less-secure-apps-oauth-google-username-password-incorrect.html
https://docs.microsoft.com/en-us/exchange/collaboration/shared-mailboxes/shared-mailboxes
meta-inf.hu
Outgoing Mail Connections
Overriding hostname for an OAuth2-based Microsoft365 SMTP connection
Overriding hostname for an OAuth2-based Microsoft365 SMTP connection