Tracking Water Usage in Home Assistant with AquaHawk
In a previous post, I mentioned wanting to track water usage from AquaHawk in Home Assistant. Many municipal water utilities provide AquaHawk portals that show water usage data, including consumption graphs and leak detection. I built a custom integration to bring this data into Home Assistant’s Energy Dashboard.
What is AquaHawk?
AquaHawk is a cloud-based water monitoring platform used by many municipalities to provide customers with access to their water usage data. If your water utility uses AquaHawk, you likely have access to a web portal that shows your daily and hourly water consumption, along with leak alerts and usage comparisons.
The problem is that this data is locked in their web portal. To get it into Home Assistant, I created a custom integration that pulls the data from their API.
Installing the AquaHawk Integration
Via HACS (Recommended)
The easiest way to install the integration is through HACS:
- Open Home Assistant and navigate to HACS → Integrations
- Click the + Explore & Download Repositories button
- Search for “AquaHawk”
- Click Download
- Restart Home Assistant
- Go to Settings → Devices & Services → Add Integration
- Search for “AquaHawk” and follow the setup wizard
For manual installation, see the GitHub repository.
Configuration
During setup, you’ll need to provide:
- AquaHawk hostname: The URL of your utility’s AquaHawk portal (e.g.,
myutility.aquahawk.us) - Account ID: Your account number with the utility
- Username: Your AquaHawk login username
- Password: Your AquaHawk login password
The integration creates two sensors:
| Sensor | Description |
|---|---|
sensor.aquahawk_daily | Water usage for the current day |
sensor.aquahawk_yearly | Water usage for the current year |
Adding Water to the Energy Dashboard
Home Assistant’s Energy Dashboard supports water tracking alongside electricity and gas. To add your AquaHawk data:
- Go to Settings → Dashboards → Energy
- In the Water consumption section, click Add water source
- Select AquaHawk Yearly as the water source
Important: Use the yearly sensor, not the daily sensor. The Energy Dashboard expects a continuously incrementing value that resets annually, which matches how the yearly sensor works. Using the daily sensor will result in incorrect calculations.
Once configured, you’ll see your water usage alongside your electricity consumption in the Energy Dashboard.
A Note on Data Delays
One limitation to be aware of: sensor values are delayed due to how water meters communicate with the cloud. In my experience, the delay is typically several hours to a full day. This is a limitation of the AquaHawk platform itself, not the integration.
This means the data is best suited for historical analysis and trend tracking rather than real-time monitoring. For leak detection, I still rely on the alerts from AquaHawk’s portal, though you could set up automations in Home Assistant to notify you when daily usage exceeds a threshold.
Conclusion
Integrating AquaHawk with Home Assistant brings your water usage data into the same dashboard as your electricity, giving you a complete picture of your home’s resource consumption. Combined with the DTE rate integration I wrote about previously, you can now track both electricity costs and water usage in one place.
The integration is open source and available on GitHub. Pull requests and issue reports are welcome!