Jira Automation for Mail Me
- Liliia Ostrovska
Jira Automation is a valuable feature that automates communication inside and outside the teams.
This Jira feature allows you to create rules that consist of triggers, conditions, and actions.
Triggers are events that initiate the rule, such as an issue being created, updated, or transitioned.
Conditions specify criteria that must be met for the rule to be executed.
Actions define what happens when a rule is triggered.
We have provided a use case of Jira Automation for Mail Me below. This scenario is just an example. Feel free to create rules based on your specific needs.
Jira Automation for Mail Me requires an automation token.
How to Create Automation Token
Being signed in to your Jira Cloud instance, select Apps, and then select Mail Me.
Select Tokens, and then select Automation token.
Enter the name for your token in the corresponding field, and then select Create Token.
Select Copy to copy your token.
Before closing the window, make sure to copy your new API token. You won’t be able to see this token again.
How to Create Rule
This use case describes how to automate email notification if new comments were added to an issue. You are free to select any other trigger for your rule.
Select Projects, and then select the project where you want to set up automation.
Select Project settings.
Select Automation, and then select Create rule.
Select Issue commented.
Select Save.
Select THEN: Add an action.
In the search box, enter web, and then select Send web request.
In the Web request URL* field, enter the following URL (you can just copy-paste it):
https://mailme-prod.alphaservesp.com/automation-api/email/send
In the Headers fields, first, enter the word AUTHORIZATION, and then paste the token you’ve created here.
In the HTTP method* field, select PUT.
In the Web request body, select Issue data (Jira format).
Determine the recipients, and then select Save.
These configurations are enough to set up automation for Mail Me, but it’s significant to understand how recipients are determined.
Option 1
Select +Add.
In the Headers fields, first, enter the word RECIPIENTS, and then enter the email address of the recipients.
If there are a few recipients, enter their email separated by comma (e.g. name@gmail.com, name2@yahoo.com).
Option 2
If you don’t specify recipients in the web request form, the system will use default recipients from the General Settings of Mail Me.
Next, the system will also consider default recipients from the project settings, specially from the project where the trigger was activated. For example, if you added comments to an issue located in the ABC project, the system will load default recipients from the ABC project.
The system combines all recipients (from web request form, General Settings, and Projects settings) into one list, and then sends them email.
If recipients are not specified in any of these fields, the email won’t be sent.
