Notification Settings
The Notification Settings let you configure a connection with a mail server for the delivery of email notifications.
To access this page, click the Administration icon in the application header, then select Notification Settings.
Special Requirements for Connecting to Gmail
To send YouTrack notifications using a Gmail account, you need to generate and use an application-specific password (App Password). The Google account that you use for authentication must have 2-Step Verification enabled. To connect to the Gmail service with this account, generate an application-specific password in your Google account.
For the Username, enter the username for your Google account.
For the Password, enter an application-specific password that you generated in Google.
To learn more about app passwords for Google accounts, please refer to the Gmail Help.
Prerequisites for Sending Email With the Microsoft Graph API
Before you can enable email notifications using the Microsoft Graph API, you need to register an application in the Microsoft Entra ID platform and configure it to send email. Here's a general overview of the required steps:
Register a Microsoft Entra ID application.
Create a new application in the Microsoft Entra ID Portal.
Generate a client secret for the application.
Note and securely store the Tenant ID, Client ID, and Client Secret.
You will need to provide these values when setting up the connection.
Assign API permissions.
Navigate to the API permissions section of your application.
Add the
Mail.Sendpermission as an Application permission (not Delegated).Grant admin consent for the permission to ensure it is active for the entire tenant.
Designate a user account for sending email. Ensure the user has:
Full membership status (guest accounts are not supported).
An active mailbox.
By completing these steps, you will have met the prerequisites for sending email notifications using the Microsoft Graph API. For detailed instructions, please refer to the official documentation for Microsoft Graph.
Enable Email Notifications
To send email notifications from Hub, you need to establish a connection with an external email service. YouTrack supports multiple protocols for sending mail, including standard SMTP and Microsoft 365 via the Graph API. Depending on the selected protocol, different configuration settings and prerequisites apply. This section guides you through the steps required to enable email notifications and configure the connection to your preferred email service.
To enable email notifications:
From the Server Settings section of the Administration menu, select Notification Settings.
Click the Configure mail server button.
Enter values for the following settings:
Setting
Description
Protocol
Select the protocol used by your mail server.
Connect anonymously
If your mail server does not require authentication, enable this option.
When enabled, Hub connects to your mail service without sending a username and password. The input fields for the Username and Password are disabled. Values that are stored in these settings are ignored.
Host
Enter the server address of your mail server.
Port
Enter the connection port for the mail server.
Email "From" address
Enter an email address to use as the "From" address for email notifications. A "From" address has two components:
The first part is the sender name.
The second part is the email address itself.
To specify values for both components, use the format
"sender name" <email@yourdoman.com>.In many email clients, only the sender name is displayed. Others discard the sender name and display only the email address. If you do not specify a value for the sender name, the email address is also shown as the sender name in the email client.
Username
Enter the username of the account that is used to access the mail server.
If you're connecting to Gmail, additional security requirements may apply. For details, see Special Requirements for Connecting to Gmail.
Password
Click the Change password button. This opens the Change Password dialog. Enter the password for the account that is used to access the mail server, then click the Change button to save the password and close the dialog.
SSL key
Select an SSL key to encrypt the connection between Hub and the SMTP server. For details, see SSL Keys.
Setting
Description
User email
Enter the email address of the user account designed to send email for your Microsoft Entra ID application.
Tenant ID
Enter the Tenant ID assigned to your Microsoft Entra ID application.
Client ID
Enter the Client ID for your Microsoft Entra ID application.
Client secret
Click the Change secret button. This opens the Change Client Secret dialog. Enter the secret for your Microsoft Entra ID application, then click the Change button to save the secret and close the dialog.
When finished, click the Save button.
Click the Enable notifications button in the application header.
Test the connection.
Click the Send test message button.
Enter an email address to which the test message should be sent.
Click the Send button.
Check the email account that you sent the test message to and verify that the message was delivered.
If successful, the connection to your external mail service is configured and ready for use.
If unsuccessful, update your settings and test the connection until the message delivery is successful.