Get started

Sentry issue alert notifications on your phone.

Get a push notification when one of your Sentry issue alert rules fires, with priority based on the error's level.

Install in Studio See the setup
event_alertDeveloper toolsMonitoring
How it works

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 Sentry

Add it as a webhook for Issue alert.

STEP 03

Get a push on your phone

With the text, sound and buttons from the recipe.

Setup

How to set up the Sentry issue alert webhook

  1. Click Install in Studio and sign in. The recipe is added to your account and you get a personal webhook URL.
  2. In Sentry, go to Settings > Developer Settings > Custom Integrations and create an Internal Integration.
  3. Paste your webhook URL as the Webhook URL and follow the setup notes below for Issue alert.https://••••••••/•••••••• your personal URL, shown after install
  4. Save the integration.
  5. In your internal integration (**Settings → Developer Settings → Custom Integrations**), turn on **Alert Rule Action** and save.
  6. Then open an issue alert rule (**Alerts → Create Alert → Issues**, or edit an existing one) and add the action **Send a notification via _your integration_**. Every time that rule fires, you get a push.
  7. Sentry signs each request with a `Sentry-Hook-Signature` header, but JustPush doesn't check it yet, so keep your endpoint URL private.
The code

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// Sentry → issue alert (event_alert)
2// Fires when one of your Sentry issue alert rules triggers and its action is
3// "Send a notification via <your internal integration>".
4// Docs: https://docs.sentry.io/organization/integrations/integration-platform/webhooks/issue-alerts/
5
6// Sentry levels → push priority. Fatal crashes get Highest, debug noise stays quiet.
7const LEVELS = { fatal: 2, error: 1, warning: 0, info: -1, debug: -1 }
8
9// Look a key up in one of the tables above, ignoring 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
19function handleRequest(request) {
20 const body = request.body || {}
21 const event = body.data?.event
22
23 // Guard: only issue alerts, so other Sentry webhooks on this integration stay quiet.
24 if (body.action !== "triggered" || !event) {
25 console.log(`Ignoring Sentry "${body.action ?? "unknown"}" webhook — not an issue alert`)
26 return null
27 }
28
29 // Tags arrive as [key, value] pairs.
30 const tags = Array.isArray(event.tags) ? event.tags : []
31 const environment = tags.find((tag) => Array.isArray(tag) && tag[0] === "environment")?.[1]
32 const rule = body.data.triggered_rule
33 const details = [rule, event.culprit, environment].filter((part) => typeof part === "string" && part.trim())
34
35 return {
36 title: `🚨 ${event.title || "Sentry alert"}`,
37 message: details.join(" · ") || "An issue alert triggered",
38 topic: "Sentry",
39 priority: pick(LEVELS, event.level, 1),
40 buttons: link(event.web_url, "View in Sentry"),
41 }
42}
Payload

The Sentry event_alert webhook

This is what Sentry sends to your URL for issue alert. It is a sample, trimmed to the fields recipes use.

event_alert · sample.json
1{
2 "data": {
3 "event": {
4 "url": "https://sentry.io/api/0/projects/acme/web/events/e4874d664c3540c1a32eab185f12c5ab/",
5 "tags": [
6 [
7 "browser",
8 "Chrome 140"
9 ],
10 [
11 "environment",
12 "production"
13 ],
14 [
15 "level",
16 "error"
17 ]
18 ],
19 "level": "error",
20 "title": "TypeError: Cannot read properties of undefined (reading 'total')",
21 "culprit": "app/checkout/Summary.tsx in renderTotals",
22 "web_url": "https://acme.sentry.io/issues/1117540176/events/e4874d664c3540c1a32eab185f12c5ab/",
23 "datetime": "2026-09-29T08:06:17.677000Z",
24 "event_id": "e4874d664c3540c1a32eab185f12c5ab",
25 "issue_id": "1117540176",
26 "platform": "javascript",
27 "issue_url": "https://sentry.io/api/0/issues/1117540176/"
28 },
29 "issue_alert": {
30 "title": "Checkout errors",
31 "settings": []
32 },
33 "triggered_rule": "Checkout errors"
34 },
35 "actor": {
36 "id": "sentry",
37 "name": "Sentry",
38 "type": "application"
39 },
40 "action": "triggered",
41 "installation": {
42 "uuid": "a8e5d37a-696c-4c54-adb5-b3f28d64c7de"
43 }
44}
FAQ

Sentry issue alert 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 Sentry 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.

More recipes

More from Sentry

Sentry

Metric alert

Get a push notification when a Sentry metric alert (error rate, latency, crash-free sessions, …) goes critical, warning, or resolves.

metric_alertButtons
Sentry

New issue

Get a push notification whenever Sentry sees a brand-new issue, with priority based on Sentry's own issue priority.

issue.createdButtons

All 3 Sentry recipes

Monitoring

More monitoring recipes

Arize AX

Monitor alert

Get a push notification when an Arize AX monitor triggers, clears, or stops receiving data.

monitor.triggeredButtons
Better Stack

Incident

Get a Highest-priority push notification when a Better Stack incident starts, and quiet ones when it's acknowledged or resolved, plus incident comments.

incident_changeButtons
Better Stack

On-call change

Get a push notification when the on-call person changes on a Better Stack on-call calendar.

on_call_change

All monitoring recipes

Ready when you are

Sentry on your phone in two minutes.

Install the recipe, paste one URL, done. Free for 30 days, no credit card required.

Install in Studio Download for iOS Download for Android