Jira issue status changed notifications on your phone.
Get a push notification when a Jira issue moves to another status, or only when it's done.
Monday 5 October
9:41
JustPushnow
Issue status changed
Get a push notification when a Jira issue moves to another status, or only when it's done.
Three steps to your first push
STEP 01
Install the recipe
One click in Studio gives you a personal webhook URL.
STEP 02
Paste your URL into Jira
Add it as a webhook for Issue: updated.
STEP 03
Get a push on your phone
With the text, sound and buttons from the recipe.
How to set up the Jira issue: updated webhook
- Click Install in Studio and sign in. The recipe is added to your account and you get a personal webhook URL.
- In Jira, go to Settings > System > WebHooks and click Create a WebHook (Jira admins only).
- Paste your webhook URL as the URL. Optionally limit it with a JQL filter such as project = ABC.https://••••••••/•••••••• your personal URL, shown after install
- Tick Issue: updated and save.
- Create an admin webhook under **Settings → System → WebHooks** and tick **Issue: updated**. Every status change pushes; to only hear about finished work (statuses in the **Done** category), use:
- ```
- your webhook URL?done=1
- ```
- You can also narrow it with the webhook's JQL box, for example `project = SHOP AND type = Bug`.
- Admin webhooks can have a **Secret**, which Jira uses to sign each delivery (`X-Hub-Signature: sha256=…`), but JustPush doesn't check that signature yet, so keep your endpoint URL private.
What runs when the webhook arrives
Studio calls handleRequest(request) with the incoming webhook and sends the message it returns. It's yours after install; change anything.
transform.js
1// Jira → jira:issue_updated (issue status changed)
2// Fires when an issue moves to another status (To Do → In Progress → Done …).
3// Add ?done=1 to the URL to only hear about issues moving into a Done-category status.
4// Docs: https://developer.atlassian.com/cloud/jira/platform/webhooks/
5
6// Status categories (new, indeterminate, done) → emoji.
7const CATEGORIES = { new: "📋", indeterminate: "🚧", done: "✅" }
8
9// Look a key up in a table without tripping over inherited names like "toString".
10function pick(table, key, fallback) {
11 return Object.prototype.hasOwnProperty.call(table, key) ? table[key] : fallback
12}
13
14// Only link to real http(s) URLs.
15function link(url, cta) {
16 return typeof url === "string" && /^https?:\/\//.test(url) ? [{ cta, url }] : []
17}
18
19// Query flags such as ?done=1.
20function flag(request, name) {
21 return ["1", "true", "yes"].includes(String(request.query?.[name] ?? "").toLowerCase())
22}
23
24// issue.self is the REST URL (https://acme.atlassian.net/rest/api/2/issue/10001); the browse
25// link lives on the same site: https://acme.atlassian.net/browse/ABC-123.
26function browse(issue) {
27 const match = typeof issue?.self === "string" ? issue.self.match(/^(https?:\/\/.+?)\/rest\//) : null
28 return match && typeof issue.key === "string" ? `${match[1]}/browse/${issue.key}` : null
29}
30
31function handleRequest(request) {
32 const body = request.body && typeof request.body === "object" ? request.body : {}
33 const issue = body.issue && typeof body.issue === "object" ? body.issue : null
34 const items = Array.isArray(body.changelog?.items) ? body.changelog.items : []
35 const change = items.find((item) => item && (item.fieldId === "status" || item.field === "status"))
36 const fields = issue?.fields ?? {}
37 // Read the changelog's own "toString", never Object.prototype.toString.
38 const changed = change ? pick(change, "toString", null) : null
39 const status = typeof changed === "string" && changed ? changed : fields.status?.name
40
41 // Guard: only issue updates where the status changed.
42 if (body.webhookEvent !== "jira:issue_updated" || !issue || !change || typeof status !== "string" || !status) {
43 console.log("Not a Jira status change — skipping")
44 return null
45 }
46
47 const category = fields.status?.statusCategory?.key
48 // ?done=1 limits pushes to issues landing in a Done-category status.
49 if (flag(request, "done") && category !== "done") {
50 console.log(`Skipping move to "${status}"`)
51 return null
52 }
53
54 const details = [
55 fields.summary,
56 fields.assignee?.displayName,
57 body.user?.displayName ? `by ${body.user.displayName}` : null,
58 ].filter((value) => typeof value === "string" && value)
59
60 return {
61 title: `${pick(CATEGORIES, category, "🔁")} ${issue.key ? `${issue.key} ` : ""}→ ${status}`,
62 message: details.join(" · ") || "Status changed",
63 topic: "Jira",
64 priority: category === "done" ? 0 : -1, // Done is worth a look; other moves are quiet
65 buttons: link(browse(issue), "Open issue"),
66 }
67}
The Jira jira:issue_updated webhook
This is what Jira sends to your URL for issue: updated. It is a sample, trimmed to the fields recipes use.
jira:issue_updated · sample.json
1{
2 "user": {
3 "self": "https://acme.atlassian.net/rest/api/2/user?accountId=5b10ac8d82e05b22cc7d4ef7",
4 "active": true,
5 "accountId": "5b10ac8d82e05b22cc7d4ef7",
6 "accountType": "atlassian",
7 "displayName": "Jane Doe"
8 },
9 "issue": {
10 "id": "10231",
11 "key": "SHOP-88",
12 "self": "https://acme.atlassian.net/rest/api/2/issue/10231",
13 "fields": {
14 "status": {
15 "id": "10002",
16 "name": "Done",
17 "statusCategory": {
18 "id": 3,
19 "key": "done",
20 "name": "Done"
21 }
22 },
23 "project": {
24 "id": "10000",
25 "key": "SHOP",
26 "name": "Webshop"
27 },
28 "summary": "Checkout total is off by one cent",
29 "assignee": {
30 "active": true,
31 "accountId": "5b10a2844c20165700ede21g",
32 "displayName": "Sam Lee"
33 },
34 "priority": {
35 "id": "2",
36 "name": "High"
37 },
38 "issuetype": {
39 "id": "10004",
40 "name": "Bug"
41 }
42 }
43 },
44 "changelog": {
45 "id": "10187",
46 "items": [
47 {
48 "to": "10002",
49 "from": "3",
50 "field": "status",
51 "fieldId": "status",
52 "toString": "Done",
53 "fieldtype": "jira",
54 "fromString": "In Progress"
55 },
56 {
57 "to": "10000",
58 "from": null,
59 "field": "resolution",
60 "fieldId": "resolution",
61 "toString": "Done",
62 "fieldtype": "jira",
63 "fromString": null
64 }
65 ]
66 },
67 "timestamp": 1759058400000,
68 "webhookEvent": "jira:issue_updated",
69 "issue_event_type_name": "issue_generic"
70}
Jira issue status changed notifications: questions
Does this work on iPhone and Android?
Yes. Install the JustPush app from the App Store or Google Play and sign in. Every phone signed in to your account gets the notification.
Do I need to write code?
No. Install the recipe in Studio, paste your webhook URL into Jira and you are done. The code is there if you want to change the text, the sound or the buttons.
Can I change what the notification says?
Yes. After install the recipe's code is yours. Edit it in Studio and test it against the sample payload before you save.
What does it cost?
JustPush is free for 30 days. After that it's $19.99 a year, or $39.99 once. There is no extra charge for recipes.
Ready when you are
Jira on your phone in two minutes.
Install the recipe, paste one URL, done. Free for 30 days, no credit card required.