Skip to main content
Back to Blog
Guide

How to Connect a Hydrific Droplet to WashConsole

A step-by-step guide to streaming your Hydrific Droplet's water-flow data into WashConsole over encrypted MQTT — provision credentials in WashConsole, paste them into the Hydrific app, and watch live flow, daily usage, and leak alerts show up on your Sensors page. Includes the two mistakes that trip most people up.

WCWashConsole Team/July 11, 2026/6 min read
The Hydrific app's MQTT authentication screen with the WashConsole broker host, username, discovery prefix, and status topic filled in.

What you'll get

The Hydrific Droplet is a clamp-on water-flow sensor. Once it's streaming to WashConsole, your Sensors page shows the Droplet's live flow (L/min), today's water usage, peak flow, signal strength, and a leak-watch alert you can set to email and push your managers when water runs longer than it should.

The Droplet talks to WashConsole over encrypted MQTT (MQTTS) — it connects straight to our broker with TLS, so nothing extra runs on-site. Setup is a one-time copy of a handful of values from WashConsole into the Hydrific phone app.

Editor's note (pre-publish): drop the setup screenshots into public/marketing/blog/ at the paths referenced below (droplet-choose-integration.png, droplet-pairing.png, droplet-mqtt-fields.png, droplet-connected.png, droplet-in-sensors.png). They render inline once added.

Before you start

The Droplet is installed on a water line and paired in the Hydrific phone app over Bluetooth (the app's normal first-run setup).
You're an owner, manager, or site lead in WashConsole (the roles that can add devices).
You have the Hydrific app and WashConsole open — ideally WashConsole on the same phone, so you can copy-paste between them instead of retyping.

Step 1 — Generate credentials in WashConsole

1
In WashConsole, open Sensors and choose Add Droplet.
2
Enter the Droplet's device id exactly as the Hydrific app shows it on the pairing screen — for example 12A0. WashConsole mints a set of credentials scoped to that one device.
This is the #1 thing to get right. The id you type becomes the device's security scope. If the Droplet's id is 12A0 and you type 120A, the Droplet will connect but every reading it sends is rejected, and it never shows up on your Sensors page. Copy the id character-for-character from the Hydrific pairing screen — don't type it from memory.

WashConsole then shows you a set of values to copy: Host Name, Port Number, Username, Password, Discovery Prefix, Status Topic, and a CA Certificate. Keep this screen open — you'll paste each one into the Hydrific app next. (The password is shown once; reopen Add Droplet later or use Rotate password if you need it again.)


Step 2 — Open the MQTT integration in the Hydrific app

In the Hydrific app: Menu → Droplet Settings → Smart Home Integrations → Choose integration → MQTT.

The Hydrific app's Choose Integration screen with Home Assistant and MQTT options.
The Hydrific app's Choose Integration screen with Home Assistant and MQTT options.

Then Pair to Droplet — let it scan and select your Droplet when it appears (its id, e.g. Droplet-12A0, is shown on the card), and tap Continue.

The Hydrific Pair to Droplet screen showing a discovered Droplet-12A0.
The Hydrific Pair to Droplet screen showing a discovered Droplet-12A0.

Step 3 — Enter the WashConsole MQTT settings

Now fill in the MQTT form. The field names in WashConsole match the Hydrific app's field names exactly — copy each value into the field with the same name, top to bottom.

The Hydrific MQTT authentication form filled in with the WashConsole values.
The Hydrific MQTT authentication form filled in with the WashConsole values.

| Hydrific field | What to paste |

|---|---|

| Host Name | The broker host from WashConsole. Paste it exactly — a single typo shows up as the Droplet's "Error 108". |

| Port Number | 8883 |

| Username | The wc-…-droplet-… value. This is your credential, not the Host Name. |

| Password | The long random string from WashConsole. |

| Discovery Prefix | The wc/… value. This is not the Password. |

| Status Topic | The wc/…/status value from WashConsole. Replace the app's homeassistant/status default — our broker only authorizes this topic. |

Turn TLS Encryption ON, then paste the CA Certificate as the whole block, including the `-----BEGIN CERTIFICATE-----` and `-----END CERTIFICATE-----` lines. Don't retype it or let the app reformat it — a mangled certificate is the Droplet's "Error 102".

Tap Authenticate.

The Hydrific app showing Connection established.
The Hydrific app showing Connection established.

Step 4 — Claim it in WashConsole

Back in WashConsole's Sensors page, your Droplet appears under Discovered devices within about 30 seconds of connecting. Tap Claim…, pick Hydrific Droplet — Water-Flow Sensor, and assign it a zone and equipment so its readings and alerts route to the right place.

The WashConsole Sensors page showing the Droplet's live water-flow card.
The WashConsole Sensors page showing the Droplet's live water-flow card.

That's it. You'll see live flow and today's usage on the card, a 24-hour flow trend in the device detail, and you can set a leak-watch threshold so WashConsole alerts your managers when flow stays high for too long.


Troubleshooting: "it connected, but I don't see it"

"Connection established" in the Hydrific app only means the login worked — not that readings are getting through. If the Droplet doesn't appear on Sensors, check these in order:

1
Device id typo. The most common cause. The id in your Username (…-droplet-XXXX) must match the Droplet's real id from the pairing screen exactly. 12A0 and 120A are not the same — if they don't match, the broker accepts the login but rejects every reading. Re-open Add Droplet with the correct id, copy the fresh Username + Password, and paste them in.
2
Username vs. Host Name. The Username is the wc-… value, not the broker host.
3
Discovery Prefix vs. Password. The Discovery Prefix is the wc/… value, not the password.
4
Status Topic. It should be your wc/…/status value, not homeassistant/status.
5
CA certificate. Make sure it kept its BEGIN/END lines and TLS is ON.

WashConsole's Add Droplet screen has a live connection check that watches for your Droplet and calls out these exact issues if it doesn't see readings within a couple of minutes.


A note on how it works

The Droplet publishes telemetry only — flow, volume, signal, and health. It doesn't accept remote commands, and its own leak detection lives in the Hydrific app. WashConsole does its own continuous-flow leak alerting on top of the live data, so the leak threshold you set in WashConsole is a WashConsole alert, not a change to the device. Your water data also continues to flow to Hydrific's (LIXIL's) cloud as usual — adding the WashConsole path doesn't change that.

Chat