

Setting this value in your project lets you manage incoming and outgoing messages with a dedicated email address. This setting overrides the global From address that is used for generic notifications. 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. Later in this setup, you create a mailbox rule that references the project. Import the trusted certificates for your mail server into YouTrack.ĭefine the rules that are applied to incoming email messages.īefore you start, create a project or configure an existing project to manage issues that are created by the mailbox integration. Set the schedule for fetching email messages. This procedure requires the following steps:Ĭonfigure the project that you want to use to manage issues that are created by the integration. To process incoming email messages as issues in YouTrack, you must first enable and configure the Mailbox integration. YouTrack finds the issue with the same summary that has the lowest ID number and adds a relates to link to it. YouTrack creates an issue and sets the message subject (minus the text strings that are ignored) as the issue summary. If the option in the mailbox rule is enabled, text that is set in square brackets is also ignored. The prefixes that are added to forwarded messages and replies (FW:, RE:) are ignored. YouTrack processes these messages as follows: 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. To learn more about signed links for issue attachments, see Links to Issue Attachments. The recipient of the email reply can open and view these attachments without logging in to YouTrack. These links are signed by the user who attached the files and provide direct access to the 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. The message subject contains the ID of an issue in the same project. 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. This is a standard method of parsing MIME-encoded messages.

The values for the message-id/ in-reply-to properties in the message header match a previously processed email message. YouTrack matches an incoming message to an existing issue under the following conditions:

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. Like any issue that is created manually, YouTrack assigns the issue an ID in the selected project. The reporter can either be the message author or a default user. The mailbox rule that processes the email message determines which user is set as the reporter. The message body is copied to the issue description. The message subject is copied to the issue summary. YouTrack uses the following information from an email message to create a new issue: If YouTrack cannot find any values that associate an incoming message with an existing issue, a new issue is created. The messages are processed according to the mailbox rules that are defined for the project. Each message is parsed and analyzed by YouTrack. This integration pulls email messages from an external mail service. The Mailbox Integration transforms incoming email messages into issues and comments in YouTrack.
