Get started

Shelly water leak detected notifications on your phone.

Get a Highest-priority push notification the moment a Shelly Flood sensor detects water.

Install in Studio See the setup
flood.alarmSmart homeSecurity
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 Shelly

Add it as a webhook for Flood alarm.

STEP 03

Get a push on your phone

With the text, sound and buttons from the recipe.

Setup

How to set up the Shelly flood alarm webhook

  1. Click Install in Studio and sign in. The recipe is added to your account and you get a personal webhook URL.
  2. Open your Shelly device's web interface (browse to its IP address) or the Shelly Smart Control app and go to Actions.
  3. Add a webhook action for the Flood alarm event.
  4. Use the URL from the setup notes below. Shelly fills in the ${…} parts itself when it calls it.
  5. Save, then trigger the device once to send a real event.
  6. Use this as the action URL:
  7. ```
  8. your webhook URL?event=flood.alarm&device=${config.sys.device.name}https://••••••••/•••••••• your personal URL, shown after install
  9. ```
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// Shelly → flood alarm
2// Fires when a Shelly Flood sensor detects water.
3//
4// Add a webhook action for the "flood.alarm" event on the device, calling:
5// <integration URL>?event=flood.alarm&device=${config.sys.device.name}
6
7// Shelly webhooks are GET requests, so the data arrives as query parameters.
8// Fall back to a JSON body so the recipe also works when POSTed (and in the Test runner).
9function readParams(request) {
10 const body = request.body && typeof request.body === "object" ? request.body : {}
11 return { ...body, ...(request.query || {}) }
12}
13
14// Shelly fills an unset name in as "null"; treat that (and blanks) as missing.
15function text(value) {
16 const s = value == null ? "" : String(value).trim()
17 return s === "" || s === "null" || s === "undefined" ? null : s
18}
19
20function handleRequest(request) {
21 const params = readParams(request)
22
23 // Guard: only handle flood alarms, so other Shelly hooks on this integration stay quiet.
24 if (params.event !== "flood.alarm") {
25 console.log(`Ignoring Shelly event "${params.event ?? "unknown"}" — not a flood alarm`)
26 return null
27 }
28
29 const device = text(params.device) ?? "Your Shelly Flood"
30
31 return {
32 title: "💧 Water leak detected",
33 message: `${device} detected water`,
34 topic: "Shelly",
35 priority: 2, // Highest — water damage gets worse by the minute
36 // sound: "siren", // any of Studio's sounds, e.g. incoming, bugle, siren
37 }
38}
Payload

The Shelly flood.alarm webhook

This is what Shelly sends to your URL for flood alarm. It is a sample, trimmed to the fields recipes use.

flood.alarm · sample.json
1{
2 "event": "flood.alarm",
3 "device": "Under sink"
4}
FAQ

Shelly water leak detected 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 Shelly 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 Shelly

Shelly

Button pressed

Get a push notification when a button wired to a Shelly input is pressed — perfect for a doorbell or gate button.

input.button_pushSound
Shelly

Humidity too high

Get a low-priority push notification when a Shelly humidity sensor rises above a limit you choose, so you know when to air a room.

humidity.change
Shelly

Smoke alarm

Get a Highest-priority push notification when a Shelly Plus Smoke detector goes into alarm.

smoke.alarmSound

All 7 Shelly recipes

Security

More security recipes

GitHub

Dependabot alert

Get a push notification when Dependabot finds a vulnerable dependency, with priority based on the severity.

dependabot_alertButtonsSigned
UniFi Protect

Doorbell ring

Get a Highest-priority push notification the moment someone presses your UniFi Protect doorbell, with a button to open the event clip.

ringSoundButtons
UniFi Protect

Glass break heard

Get a Highest-priority push notification when a UniFi Protect camera hears glass breaking, with a button to open the event clip.

alrmGlassBreakSoundButtons

All security recipes

Ready when you are

Shelly 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