Atlassian Jira

Reward developers as they action tickets and other work issues.

Send perks to users by creating a project automation.

Refer to the Jira automation documentation for more information about using outgoing webhooks.

Prerequisites

• An existing promotion with a token.

• Admin access to a Jira project

Instructions

1. In the Jira Project Settings, choose Automation.

2. Click Create rule button.

3. Choose the applicable trigger for the reward. To get started select Field value changed. Modify the trigger conditions to match your use case.

4. Click Next.

5. Click IF: Add a condition.

6. Select Issue fields condition.

7. Select field Status and Condition "equals".

8. Under Value select an appropriate status such as Done or Resolved.

9. Click Next.

10. Click THEN: Add an action. Choose Send web request.

11. Enter the following values:

    • Web request URL: https://perk.exchange/api/perks

    • HTTP method: POST

    • Web request body: Custom data

    • Custom data: {"platform": "email", "user_id": "{{issue.assignee.emailAddress}}"}

    • Headers, enter x-perk-token in the first text box and XXXXXXXX in the second box. Replace XXXXXXXX with your promotion token.

    • Click Next.

    
12. Click Turn on rule button to activate the rule.

13. Assign a memorable name to this rule; such as: "Issue Perk"

Other use cases

Comment

• Create a trigger for Work logged events to reward users when they track their time.

NOTE: Additional placeholders like issue.assignee.emailAddress are documented online.