Send notifications via a SMTP Relay Service

Owned by Mike Harrison, created
Last updated: Feb 28, 2024 by Ryan Clifton
3 min read

Email service providers often set limits in terms of the number of emails that an account can send hourly/daily. This might not be a problem if you are not sending many notifications, however for high-traffic Jira instances limits may be too small. SMTP relay services usually offer higher limits and are therefore better suited for sending out large numbers of Jira notifications.

Below we give set up instructions for some of the well-known SMTP relay services, however other providers should also work.

Gmail - Using OAuth

Gmail now support SMTP Relay when using OAuth

  1. As an Administrator for your Google accounts, follow Google’s SMTP relay service set-up guide

  2. Navigate to JEMH Cloud > Messaging > Message Outbounds

  3. Press Sign in with Gmail - For more info about Signing with OAuth see:

    Screenshot from 2024-02-28 09-45-24.png

  4. Press Edit (pen icon) on the newly created Outbound Message Source.

  5. Ensure that the Mail Server Type is set to SMTP Gmail OAuth and then change the Preset to Gmail SMTP relay

    Screenshot from 2024-02-28 09-50-05.png

Gmail - Without using OAuth

Use of plain passwords is deprecated, consider using OAuth above

  1. As an Administrator for your Google accounts, follow Google’s SMTP relay service set-up guide

  2. Navigate to JEMH Cloud > Messaging > Message Outbounds

  3. Create a new connection configuration using the ‘create’ button

  4. Fill in the connection form similar to the below, ensuring that the target host is smtp-relay.gmail.com and that the account used in the username and password fields has been granted access to the relay service through Google (as per step 1):

SendGrid

  1. Follow SendGrid’s set-up guide for SMTP relay integration. This will involve creating an API key.

  2. Enter the provided settings into the JEMHC outbound connection form, setting the username as apikey and password as the API key given by SendGrid:

     

Mailjet

  1. Set up your Mailjet account for use as a SMTP relay as per the instructions given in their set-up guide

  2. Mailjet will then provide you with the settings required in order for JEMHC to connect to it (username, password, host and port)

  3. Enter the provided settings into the JEMHC outbound connection form, for example: