YouTrack Server 2022.2 Help

Mailbox Integration

The Mailbox Integration transforms incoming email messages into issues and comments in YouTrack. This integration can be configured to support the following scenarios:

Message Processing

This integration pulls email messages from an external mail service. Each message is parsed and analyzed by YouTrack. The messages are processed according to the mailbox rules that are defined for the project.

New Issues

If YouTrack cannot find any values that associate an incoming message with an existing issue, a new issue is created. YouTrack uses the following information from an email message to create a new issue:

  • The message subject is copied to the issue summary.

  • The message body is copied to the issue description.

  • The mailbox rule that processes the email message determines which user is set as the reporter. The reporter can either be the message author or a default user.

Like any issue that is created manually, YouTrack assigns the issue an ID in the selected project.

Comments

When YouTrack detects that an incoming message is related to an existing issue, the body of the message is added to the issue as a comment. YouTrack matches an incoming message to an existing issue under the following conditions:

  • The values for the message-id/in-reply-to properties in the message header match a previously processed email message. This is a standard method of parsing MIME-encoded messages. YouTrack uses these values to thread comments when a recipient replies to notifications that are sent when an issue is created or updated in the project.

  • The message subject contains the ID of an issue in the same project.

Attachments

In email replies that are generated when comments are added to the issue in YouTrack, links are generated for new files that are attached to the issue or comment. These links are signed by the user who attached the files and provide direct access to the attachments. The recipient of the email reply can open and view these attachments without logging in to YouTrack.

To learn more about signed links for issue attachments, see Links to Issue Attachments.

In situations where the subject of an incoming message matches the summary of an existing issue, but the message does not contain any of the values that associate it with an existing issue a new issue is created. YouTrack processes these messages as follows:

  • The prefixes that are added to forwarded messages and replies (FW:, RE:) are ignored.

  • If the Do not discard the contents of square brackets option in the mailbox rule is deselected, text in the subject line of the email message that is set in square brackets is also ignored.

  • YouTrack creates an issue and sets the message subject (minus the text strings that are ignored) as the issue summary.

  • YouTrack finds the issue with the same summary that has the lowest ID number and adds a relates to link to it.

Setup

To process incoming email messages as issues in YouTrack, you must first enable and configure the Mailbox integration.

This procedure requires the following steps:

  1. Configure the project that you want to use to manage issues that are created by the integration.

  2. Set the schedule for fetching email messages.

  3. Import the trusted certificates for your mail server into YouTrack.

  4. Connect to the mail service.

  5. Define the rules that are applied to incoming email messages.

Configure Your Project

Before you start, create a project or configure an existing project to manage issues that are created by the mailbox integration. Later in this setup, you create a mailbox rule that references the project.

Set Email Addresses for the Project

To configure a project for use with the mailbox integration, set the From address to the email address that you want to use to send emails. This setting overrides the global From address that is used for generic notifications. Setting this value in your project lets you manage incoming and outgoing messages with a dedicated email address.

You also have the option to set the Reply-to address for notifications in your project. Use this setting when, for example, the address that you use to send email notifications cannot receive replies.

To set the email addresses for an existing project:

  1. Click the Projects link in the header.

  2. Select the project from the list.

  3. In the right side-panel of the project page, click the Notifications link in the Administration section.

    • The Edit Project page opens with the Notifications tab selected.

    Notifications tab in the project settings
  4. In the From address input field, enter the email address that you want to use to send emails.

  5. Optionally, enter the email address that you want to receive replies in the Reply-to address field.

Customize the Delimiter for Replies

When you are done setting up mailbox integration for the project, YouTrack automatically enables a default delimiter for the replies. It helps the mailbox integration transform replies into comments with greater precision.

If a user writes an email reply and puts their text above the delimiter line, YouTrack will then show only the latest reply and collapse the rest of the thread in a comment. Replying above the delimiter lets you keep only the relevant information in the YouTrack comments.

The delimiter text is appended to the beginning of each reply that your team members post as a comment in the project integrated with a mailbox. The default delimiter text reads Please enter your reply above this line, and it is localized to the language of your YouTrack if you change the locale. If you customize the delimiter text, it will remain the same regardless of the YouTrack language.

To disable the delimiter, open the Notifications tab in the Edit Project page and disable the Use delimiter for replies option.

To change the text of the delimiter, enter the new text in the Delimiter text field.

Delimiter for the replies

Set the Schedule for Fetching Email Messages

YouTrack fetches email messages from the specified mail services according to a schedule. The default interval is every hour. You can change the schedule to a predefined interval or specify a custom interval with a cron expression. The schedule is not set independently for multiple mail services. The same schedule is applied to all mail services that are integrated with the YouTrack server.

To specify an interval for fetching email messages:

  1. From the Administration menu, select Integrations > Mailbox Integration.

  2. From the Fetching interval drop-down menu, select a pre-configured time interval. To specify another time interval, select Custom and enter a cron expression. For example, to pull fresh data every 45 minutes, every day, use the following expression:

    0 0/45 * * * ?

    For details about cron expressions format, please refer to the cron trigger tutorial.

Import Trusted Certificates from Your Mail Server

Your mail server may require that you establish a secure connection over SSL. Before you can add your hosted server to YouTrack, you may need to import its SSL certificate.

  • If your mail server has a valid certificate that is signed by a well-known certificate authority (CA), the public key and certificate are already stored in the web browser. You should be able to connect to your mail server without importing its SSL certificate.

  • If the certificate for your mail server is self-signed, you need to import the certificate and public key to establish a secure connection.

To enable a secure connection between YouTrack and your mail server:

  1. Export the certificate and public key for your mail server as a DER-encoded file. These files use the .der, .cer, and .crt extensions.

  2. From the Administration menu, select Server Settings > SSL Certificates.

  3. Click the Import trusted certificate button.

  4. In the Import Trusted Certificate dialog, enter a name for the certificate.

  5. Click the Choose file button and select the certificate file from your local directory.

    Import trusted certificate dialog
  6. Click the Import button.

    • The certificate for your mail server is added to YouTrack.

Connect to a Mail Service

To enable the integration, you need to connect to one or more mail servers.

  • For Gmail, there are special requirements for the account that you use to connect to the mail service. For details, see Gmail.

  • For Microsoft Exchange Server and Microsoft Exchange Online (Office 365) mailboxes, additional setup is required. To configure your mail service to be compatible with this integration, read and follow the instructions for Microsoft Exchange Online or Microsoft Exchange Server.

Google accounts have settings that restrict access to third-party applications that use less secure sign-in technology. By their definition, this applies to connections that authenticate with a username and password, which are vulnerable to hijacking.

The setup requirements are based on the current setting for managing less secure apps. The requirements apply to the Google account that you use to authenticate with the Gmail service.

  • If you're connecting with a Google account that you manage yourself, generate an application-specific password (App Password) in your Google account and use it for authentication. Leave the option to enable access for less secure apps in your Google account Off.

    App Passwords can only be used with accounts that have 2-Step Verification turned on.

  • If you use a Google account that is managed by your organization as part of Google Workspace, make sure that the option to Disable access to less secure apps is switched on.

    The Google account that you store in the mailbox integration settings 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.

While you may still allow access to less secure apps, Google has indicated that it will eventually discontinue support for this type of authentication. We strongly encourage you to enable 2-Step Verification and use an App Password to authenticate with the Gmail service.

To connect to Gmail mailbox:

  1. From the Administration menu, select Integrations > Mailbox Integration.

  2. On the Mailbox Integration page, click the Add New Mail Server link.

    • The Mailbox settings are displayed in the sidebar.

      connect to a mail server
  3. Enter values for the following settings:

    Setting

    Description

    Server type

    Select the protocol that you want to use for the integration. Gmail supports the POP/POPS and IMAP/IMAPS protocols.

    Host

    Enter the URL of the mail service. For example, imap.gmail.com.

    Port

    Enter the port that the mail service listens to. The default port is set automatically when you select the mail server protocol.

    Username

    Enter the username of the account that authorizes access to the mail service.

    Password

    Enter the password for the account that you use to log in to the Gmail service.

  4. Expand the Advanced settings section and configure the following optional settings:

    Setting

    Description

    SSL Key

    For integrations with Gmail, you can ignore this setting. Connections with the Gmail service are automatically authenticated using TLS.

    Connection Timeout

    Set the maximum amount of time to wait for complete data transfer from the mail service before closing the connection. The default value is set to 60 seconds.

    Socket Timeout

    Set the maximum amount of time to wait for a response from the mail service before disconnecting the socket. The default value is set to 60 seconds.

  5. Click the Test connection button to verify the configuration. If the connection cannot be established, correct your settings and test the connection again.

  6. Click the Add Server button.

    • The mailbox integration settings are saved.

Use the following instructions to configure a connection with a generic mail service.

To connect to a generic mail service:

  1. From the Administration menu, select Integrations > Mailbox Integration.

  2. On the Mailbox Integration page, click the Add New Mail Server link.

    • The Mailbox settings are displayed in the sidebar.

      connect to a mail server
  3. Enter values for the following settings:

    Setting

    Description

    Server type

    Select the protocol that is used by the mail server. The mailbox integration supports the POP/POPS and IMAP/IMAPS protocols.

    Host

    Enter the URL of the mail service. For example, mail.server.com.

    Port

    Enter the port that the mail service listens to. The default port is set automatically when you select the mail server protocol.

    Username

    Enter the username of the account that authorizes access to the mail service.

    Password

    Enter the password for the account that you use to log in to the mail service.

  4. Expand the Advanced settings section and configure the following optional settings:

    Setting

    Description

    SSL Key

    If your mail server requires client SSL authentication, select the SSL key that identifies your YouTrack server from the list.

    The list only displays SSL keys that have already been imported into YouTrack. To learn how to generate and upload SSL keys, see SSL Keys.

    Connection Timeout

    Set the maximum amount of time to wait for complete data transfer from the mail service before closing the connection. The default value is set to 60 seconds.

    Socket Timeout

    Set the maximum amount of time to wait for a response from the mail service before disconnecting the socket. The default value is set to 60 seconds.

  5. Click the Test connection button to verify the configuration. If the connection cannot be established, correct your settings and test the connection again.

  6. Click the Add Server button.

    • The mailbox integration settings are saved.

The mailbox integration in YouTrack only supports POP/POPS and IMAP/IMAPS. The default protocol for Microsoft Exchange, MAPI, is not supported. If you want to connect to a Microsoft Exchange, you have two options:

  • Enable and configure either POP or IMAP in the Microsoft Exchange, then configure the authenticated SMTP settings. With these mail connectors enabled, you can follow the instructions below and establish a connection.

    Pay attention to the special instructions for Microsoft Exchange mailboxes.

  • Establish a connection through an intermediate gateway server. This lets you connect to the Exchange Server with POP/IMAP and SMTP disabled. The DavMail exchange gateway, for example, converts proprietary Exchange formats into email protocols that YouTrack understands. For setup instructions, refer to the DavMail Gateway documentation.

    With this setup, follow the instructions below to establish a connection to the gateway server.

An integration with Microsoft Exchange Online requires that you perform the following actions:

Register a Client Application in Microsoft Azure

This setup requires that you meet the following prerequisites:

  • A valid license for Microsoft Exchange Online.

  • Administrative access to Microsoft Azure Active Directory (AD).

To complete the migration, you will need to obtain the following information from the Microsoft platform:

  • The email address of the mailbox where you want to retrieve incoming messages. This mailbox must belong to the same Azure AD service where you register the app.

  • The Application (client) ID of the app that is registered in the Microsoft Azure portal.

  • The Directory (tenant) tenant ID of your Azure Active Directory tenant organization.

  • A client secret that you created for the registered app.

The Application (client) ID and Directory (tenant) ID can be found in the Essentials section of the client application as shown below.

The Essentials section of a registered client application in Microsoft Azure.

The client secret can be generated from the Certificates & secrets < Client secrets section.

The Certificates & secrets section of a registered client application in Microsoft Azure.

To learn how to perform this setup, please follow the instructions in the product documentation for Microsoft Azure.

Add the Required Permissions to the Client App

Next, you need to add the following API permissions to the app:

  • Mail.Read must be granted as an Application permission.

  • User.Read must be granted as a Delegated permission.

The list of permissions can be found in the API permissions settings of the client app.

The API permission settings of a registered client application in Microsoft Azure.

If you are logged in under an administrator account (as listed in the prerequisites), you can grant the application permission Mail.Read yourself. If not, you will need to ask an administrator to grant admin consent to the permissions configured for the application.

To learn how to configure permissions for a client app, please follow the instructions in the product documentation for Microsoft Azure.

Update the Mailbox Integration Settings in YouTrack

Once you have collected the required information from the Microsoft platform, you can configure the settings for your Mailbox integration in YouTrack.

To connect to a Microsoft Exchange Online mailbox:

  1. From the Administration menu, select Integrations > Mailbox Integration.

  2. On the Mailbox Integration page, click the Add New Mail Server link.

    • The Mailbox settings are displayed in the sidebar.

      connect to a mail server
  3. For the Server type setting, select Microsoft Exchange Online.

    • The integration is updated to show specific settings for this server type.

  4. Enter values for the following settings:

    Setting

    Description

    Mailbox address

    Enter the email address where the integration currently retrieves incoming messages.

    Tenant ID

    Enter the Directory (tenant) ID of the Azure Active Directory tenant organization.

    Client ID

    Enter the Application (client) ID for the registered client application in Microsoft Azure.

    Client secret

    Enter the value for the secret that you generated for the client app in Microsoft Azure.

  5. Expand the Advanced settings section and configure the following optional settings:

    Setting

    Description

    SSL Key

    If your mail server requires client SSL authentication, select the SSL key that identifies your YouTrack server from the list.

    The list only displays SSL keys that have already been imported into YouTrack. To learn how to generate and upload SSL keys, see SSL Keys.

    Connection Timeout

    Set the maximum amount of time to wait for complete data transfer from the mail service before closing the connection. The default value is set to 60 seconds.

    Socket Timeout

    Set the maximum amount of time to wait for a response from the mail service before disconnecting the socket. The default value is set to 60 seconds.

  6. To verify that YouTrack is able to establish a connection with the mail server, click the Test connection button.

  7. If the test is successful, click the Add Server button.

    • The mailbox integration settings are saved.

The mailbox integration in YouTrack only supports POP/POPS and IMAP/IMAPS. The default protocol for Microsoft Exchange, MAPI, is not supported. If you want to connect to a Microsoft Exchange, you have two options:

  • Enable and configure either POP or IMAP in the Microsoft Exchange, then configure the authenticated SMTP settings. With these mail connectors enabled, you can follow the instructions below and establish a connection.

    Pay attention to the special instructions for Microsoft Exchange mailboxes.

  • Establish a connection through an intermediate gateway server. This lets you connect to the Exchange Server with POP/IMAP and SMTP disabled. The DavMail exchange gateway, for example, converts proprietary Exchange formats into email protocols that YouTrack understands. For setup instructions, refer to the DavMail Gateway documentation.

    With this setup, follow the instructions below to establish a connection to the gateway server.

For Microsoft Exchange Server, the mailbox integration supports connections to shared mailboxes. You can use the username and password of any user who is a member of the shared mailbox to authenticate.

To connect to a mail service:

  1. From the Administration menu, select Integrations > Mailbox Integration.

  2. On the Mailbox Integration page, click the Add New Mail Server link.

    • The Mailbox settings are displayed in the sidebar.

      connect to a mail server
  3. Enter values for the following settings:

    Setting

    Description

    Server type

    Select the protocol that is used by the mail server. The mailbox integration supports the POP/POPS and IMAP/IMAPS protocols.

    Host

    Enter the URL of the mail service. For example, mail.exchange.com.

    Port

    Enter the port that the mail service listens to. The default port is set automatically when you select the mail server protocol.

    Username

    Enter the username of the account that authorizes access to the mail service.

    Password

    Enter the password for the account that you use to log in to the mail service.

  4. Expand the Advanced settings section and configure the following optional settings:

    Setting

    Description

    SSL Key

    If your mail server requires client SSL authentication, select the SSL key that identifies your YouTrack server from the list.

    The list only displays SSL keys that have already been imported into YouTrack. To learn how to generate and upload SSL keys, see SSL Keys.

    Connection Timeout

    Set the maximum amount of time to wait for complete data transfer from the mail service before closing the connection. The default value is set to 60 seconds.

    Socket Timeout

    Set the maximum amount of time to wait for a response from the mail service before disconnecting the socket. The default value is set to 60 seconds.

  5. Click the Test connection button to verify the configuration. If the connection cannot be established, correct your settings and test the connection again.

  6. Click the Add Server button.

    • The mailbox integration settings are saved.

Define Mailbox Rules

Now that you have connected YouTrack to a mail service, you can configure rules for processing incoming email messages.

Mailbox rules are processed sequentially.

  • If a message matches the filter that is defined in the first rule, it is processed according to the instructions that are defined in this rule. The message is not considered for processing by any subsequent rules.

  • If the message does not match the filter that is defined in the first rule, it is evaluated against the criteria for the second rule, and so on.

  • When a message does not match any filters, an internal record is created to register that the message was received. No further action is taken. The message is still considered to have been processed and is deleted from the mail service if the corresponding option is enabled in the mailbox rule.

You can create multiple mailbox rules that process messages in different ways. For example, you create a rule that scans the message body for words like "overdue" and "urgent" and automatically set the priority of the issue. You can then create additional rules to process the messages that don't contain these words.

To define a mailbox rule:

  1. On the Mailbox Integration Settings page, click the Add Mailbox Rule button.

    • The Rule settings are displayed in the sidebar.

      new mailbox rule
  2. Enter values for the following settings:

    Setting

    Description

    Mailbox

    Select the mailbox from which YouTrack fetches email messages.

    Project

    Select which YouTrack project is assigned to issues that are created from incoming email messages.

    Maintainer

    Select the username of the user who is responsible for the integration. The maintainer receives notifications when a command is unsuccessful or the issue reporter cannot be resolved. By default, the user who creates the rule is set as the maintainer.

  3. Click to expand the Filter settings.

    These settings determine which emails should be fetched from the mail service. These settings are optional. If you want to process all incoming emails in YouTrack, continue with the next step.

    mailbox rule filter options

    Enter values for the settings that are displayed in this section of the new rule:

    Setting

    Description

    Folder

    Choose which folder you want to use as a source for processing incoming email messages. If you select a folder, messages that are delivered to the selected folder and its subfolders are processed.

    If you don't select a folder, the integration fetches all email messages from the service except messages that have been permanently deleted. This includes messages in the sent, spam, and trash folders. For this reason, we strongly recommend that you select a folder, for example, the Inbox.

    Recipient address

    Enter an email address to fetch only email messages that are sent to this address. When used, YouTrack only applies this mailbox rule to messages that are sent directly to the specified recipient or sent as a carbon copy (as CC or BCC).

    If you set a value here, use the same email address as the From address in the project that is set as the Project for this mailbox rule. Otherwise, replies to messages that are sent by the mailbox integration are not added to issues as comments.

    To process all email messages in the specified folder, leave this field empty.

    Do not discard the contents of square brackets

    Use this option to determine whether to include text that is set in square brackets in the issues that are processed by YouTrack. This option only applies to text in the subject line of an email message.

    Ignore auto replies

    Enable to ignore email messages that are sent as automatic replies to messages that are sent from the YouTrack server. This setting prevents you from adding comments to issues when you receive automated out-of-office replies.

    Filter messages by patterns

    Enter a pattern to search for in the message subject. You can write the patterns as regular expressions. If the pattern is detected in the message subject, the email message is ignored.

    Enter multiple patterns on separate lines in the input field.

    Also apply the filter to message body

    Enable to exclude emails that contain text that matches the specified patterns in the message body.

    This option is only shown when the Filter messages by patterns option is also enabled.

  4. Click to expand the Reporter settings. These settings define which user is set as the reporter for each issue that is processed from an incoming email message.

    mailbox rule reporter options

    Select one of the following options:

    Option

    Description

    Set email sender as reporter. If no such user found in YouTrack, create new account for sender

    YouTrack tries to find a user account with an email address that matches the author of the email message. If an existing account is not found, a new user account is created. Credentials for accessing YouTrack are sent to the author in the notification message that is sent when the issue is created.

    Set email sender as reporter. If no such user found in YouTrack, set default user as reporter

    YouTrack tries to find a user account with an email address that matches the author of the email message. If an existing account is not found, a default user account is set as the reporter. Select an existing user account from the Default user drop-down list.

    Always set predefined user as reporter

    When enabled, YouTrack automatically sets the specified user as the reporter for all issues that are created from incoming email messages.

  5. Click to expand the Postprocessing settings. These settings define how YouTrack handles issues and comments that are created from incoming email messages. These settings are optional. If you don't want to automatically update issues that are processed by YouTrack, continue with the next step.

    mailbox rule postprocessing options

    Enter values for the settings that are displayed in this section of the new rule:

    Setting

    Description

    Apply command to new issues

    Enter a command to apply automatically to all issues that are created from incoming email messages. You can insert placeholders that reference values that are stored in the email message. For example:

    for [user] fromMail ${from}

    This command applies the following changes to any issue that is created from an incoming email message

    • The issue is assigned to the specified user.

    • The value for the custom field fromMail is set to the email address of the message author.

    If you need to apply several commands at once, enclose each placeholder in quotation marks. For example: toMail "${to}" fromMail "${from}". Without quotation marks, everything after the first placeholder is parsed as part of the same value.

    For details, see Placeholders.

    Apply command on new comment

    Enter a command to apply automatically when a comment is added to an issue from an incoming email message. You can also use placeholders in these commands.

    If you need to apply several commands at once, enclose each placeholder in quotation marks. For example: toMail "${to}" fromMail "${from}". Without quotation marks, everything after the first placeholder is parsed as part of the same value.

    For details, see Placeholders.

    Add recipients as watchers

    Enable to add users whose email addresses are included in the To: and CC: fields of the email message as watchers for the issues that are created from the incoming email message.

    Delete fetched messages from mailbox

    Enable to delete all messages from the mail service after the corresponding issues have been created in YouTrack.

    Original timestamps (IMAP only)

    Enable to set the creation date of the issue or comment to the timestamp of the original email message. Otherwise, the creation date is set to the date and time when the email message was processed by YouTrack.

    Prefer plain text for issue description when available

    Enable to use the plain-text version of the message for the issue description whenever the incoming message contains a plain-text version of the email. If the plain-text version is not available, the content from the HTML version of the message is wrapped in HTML tags, stored in Markdown syntax, and used for the issue description instead.

  6. Click the Add Server button.

    • The settings for the mailbox rule are saved.

    • In the settings of the target project, you can now customize the text of the delimiter that would appear in the replies to users sent by the members of your team.

Placeholders

You can use placeholders in the Postprocessing settings of a mailbox rule. These placeholders reference attributes in the original email message. The placeholder is replaced with the corresponding value in the message when it is processed by YouTrack. The following placeholders are available:

Placeholder

Description

${from}

The email address of the message author.

${from name}

The sender name of the message author.

${reply-to}

The value that is stored in the Reply-To: field of the email message header. This is the email address that is automatically inserted into the To: field when a recipient replies to an email message.

${to}

The email addresses of all message recipients that are entered in the To: field of the email message.

${cc}

The email addresses of all message recipients that are entered in the CC: field of the email message.

${bcc}

The email addresses of all message recipients that are entered in the BCC: field of the email message.

If you need to apply several commands containing placeholders in one setting, enclose each placeholder in quotation marks. For example: toMail "${to}" fromMail "${from}". Without quotation marks, everything after the first placeholder is parsed as part of the same value.

Troubleshooting

If you experience problems setting up the mailbox integration, see if any of the following conditions apply.

Condition

You are unable to establish a connection to the mail service.

Cause

The external service is unavailable.

Solution

Verify that your mail service is running.

Cause

The connection is blocked by a firewall.

Solution

Open the ports in the firewall that are used by YouTrack and the mail service.

Cause

The connection to the external service is blocked by the proxy server.

You are trying to connect over the wrong port.

Solution

Set the system properties for your server that let YouTrack connect to other services through the proxy server. For instructions, see Proxy Configuration.

Cause

The mail server requires a secure connection.

Solution

Import the certificate for your mail server into YouTrack. For instructions, see SSL Certificates.

Cause

Your SSL certificate for the mail server has expired.

Solution

Renew and import the updated certificate into YouTrack. For instructions, see SSL Certificates.

Cause

You are trying to connect to an Exchange mailbox and there are configuration problems in either the mail service or YouTrack.

Solution

Check the following setup requirements:

  • Make sure your Exchange mailbox is configured to use either POP/POPS or IMAP/IMAPS and authenticate over SMTP as described for Microsoft Exchange Online or Microsoft Exchange Server.

  • Verify that the Protocol setting in the mailbox integration matches the protocol that is enabled for your Exchange mailbox.

  • Enable the MS Exchange compatibility mode checkbox.

If you are still unable to establish a connection, submit a support request.

Condition

You are unable to establish a connection to your mail server over an unsecured protocol. YouTrack returns the error bad_request.

Cause

Your IMAP or POP3 server uses an extension that enables STARTTLS. YouTrack requires a secure connection to your mail server.

Solution

Import the SSL certificate for your mail server into YouTrack. For instructions, see SSL Certificates. If both YouTrack and your mail server run on a private computer network, you can generate and import a self-signed SSL certificate for your mail server.

Condition

Incoming email messages are not converted into issues in YouTrack.

Cause

The user that is set as the reporter for issues that are processed from incoming email messages does not have permission to create issues in the project.

Solution

Check the Reporter settings for your mailbox rules.

  • If you set the email sender as reporter, grant a Reporter role to either the All Users or the Registered Users groups for the project that is connected to the mailbox.

  • If you set a default or predefined user as reporter, grant this user a Reporter role in the project that is connected to the mailbox.

Condition

Incoming email messages are converted into issues in YouTrack. Incoming replies are not added as comments.

Cause

The From address in the project settings uses an email address that is not processed by the mailbox rule or is not set. New issues are created from messages that are sent to the mail service, but replies to incoming messages are sent from another address. Replies to these messages are not sent to the mail service that is configured for the mailbox integration.

Solution

Set the From address for the projects that are selected in your mailbox rule settings to an address that is processed by the mailbox integration.

Check the Filter settings for your mailbox rule. If you set the 'To' address, use the same email address as the From address in the project that is set as the Project for this mailbox rule.

Last modified: 30 November 2022