A Home Assistant custom component for Powershop New Zealand customers. Monitor your account balance, electricity rates, usage, and Power Pack coverage — updated every 15 minutes.
- Account Balance — current balance in NZD
- Time-of-Use Rates — off-peak, peak, and shoulder rates in c/kWh
- Usage Monitoring — today's kWh and billing period kWh
- Billing Gauges — mirrors the Powershop app: used cost, estimated total, pack coverage %, and still-to-buy shortfall for the current period
- Power Pack Tracking — total redeemable pack balance and full pack list; upcoming 5 billing periods show estimated cost vs packs already purchased
- Passwordless Auth — uses Powershop's email OTP login (no password stored)
- Automatic Token Refresh — stays authenticated silently in the background
- Regular Updates — 15-minute refresh interval
- A Powershop NZ account at app.powershop.nz - Your account must be migrated to Powershop's new platform. You can verify this by checking if you can log in at app.powershop.nz. Powershop is rolling this out gradually and you'll get an email from them letting you know your account is being migrated — if your account hasn't been migrated yet, the integration will not work.
- Home Assistant 2024.1 or later
- HACS (for managed installation)
- Open HACS in Home Assistant
- Go to Integrations
- Click the three dots (⋮) in the top right corner → Custom repositories
- Add
https://github.com/PMKA/powershop-nzand select Integration - Click Add, then find Powershop NZ in the list and install it
- Restart Home Assistant
- Download or clone this repository
- Copy the
custom_components/powershop/folder into your HA config'scustom_components/directory - Restart Home Assistant
Authentication uses a one-time password (OTP) sent to your email — no password required:
- Go to Settings → Devices & Services → Add Integration
- Search for Powershop
- Enter your Powershop account email address and click Submit
- Check your email for the one-time code and enter it, then click Submit
Your account number and property ID are discovered automatically. Home Assistant will prompt you to re-authenticate if your session ever expires — just repeat the OTP process.
| Entity | Description | Unit |
|---|---|---|
sensor.powershop_balance |
Current account balance | NZD |
sensor.powershop_off_peak_rate |
Off-peak electricity rate | c/kWh |
sensor.powershop_peak_rate |
Peak electricity rate | c/kWh |
sensor.powershop_shoulder_rate |
Shoulder electricity rate | c/kWh |
sensor.powershop_usage_today |
kWh consumed today (last 24 h) | kWh |
sensor.powershop_usage_billing_period |
kWh consumed this billing period | kWh |
sensor.powershop_cost_billing_period |
Cost for the current billing period | NZD |
sensor.powershop_period_used_cost |
Actual metered spend so far this billing period | NZD |
sensor.powershop_period_estimated_cost |
Projected total cost for this billing period | NZD |
sensor.powershop_period_still_to_buy |
How much more in packs you'd need to cover this billing period | NZD |
sensor.powershop_period_coverage_pct |
% of projected bill covered by packs already purchased | % |
sensor.powershop_voucher_balance |
Total redeemable Power Pack balance | NZD |
sensor.powershop_period_estimated_cost includes an upcoming_periods attribute — a list of the next 5 billing periods, each containing:
- period_start: "2026-05-06"
period_end: "2026-06-05"
cost_estimated_nzd: 390.78 # projected cost based on your usage pattern
voucher_bought_nzd: 0.00 # packs pre-purchased for that specific month
cost_still_to_buy_nzd: 390.78 # shortfall
coverage_pct: 0.0sensor.powershop_voucher_balance includes a vouchers attribute listing every active pack with its name, available-from date, remaining balance, and original value.
No OTP email? Check spam, make sure you're using the right address, and try again, i found at some times of day the emails were slow to come through. "Email address not found" during setup Even if your email is correct, this can happen if your account hasn't yet been migrated to Powershop's new platform. Powershop is doing a staged rollout — check if you can log in at app.powershop.nz first. If you can't, your account isn't on the new system yet and you'll need to wait or contact Powershop.
- Updated integration icon — new transparent PNG, shown in HA integrations page and HACS store
- Documented Firebase API key as public project identifier (not a secret)
- Added GitHub secret scanning allowlist to suppress false-positive alerts
- Removed developer/debug scripts from the repository
- Repository URLs updated following rename to
powershop-nz
- Fixed upcoming billing period pack coverage showing $0 for periods without dedicated future packs
- The redeemable pack pool now cascades across future periods, matching how the Powershop app calculates coverage
- Fixed all sensors showing unavailable after updating to v2.0.2
- Fixed Power Pack sensors failing to load on some accounts
- Fixed integration failing to initialise correctly on HA startup
- Various HACS compliance fixes
- Added
Used This Billing Periodsensor — actual confirmed spend (USED in app) - Added
Estimated Cost This Billing Periodsensor — full projected monthly cost (EST in app) - Added
Still To Buy This Billing Periodsensor — pack shortfall warning - Added
Billing Period Pack Coveragesensor — % of estimated bill covered by packs period_estimated_costsensor exposesupcoming_periodsattribute with 5-month forward forecast (estimated cost + pre-purchased packs per period)- Updated Power Pack query to use
availableBeforeDate/availableFromDatefilters matching the website's per-period breakdown - Daily measurements now use a dedicated date-range query that includes
readingQuality(ACTUAL vs ESTIMATED)
- Added usage sensors (today kWh, billing period kWh, billing period cost)
- Added Power Pack / voucher balance sensor
- Full rewrite for the new Powershop app (
app.powershop.nz) - Replaced HTML scraping with Firebase OTP authentication + GraphQL API
- Added account balance sensor
- Passwordless login — no password ever stored
- Automatic session refresh with long-lived tokens
- Re-authentication support via HA config flow
- Initial release
- Rate monitoring via the legacy
secure.powershop.co.nzsite
This project is licensed under the MIT License - see the LICENSE file for details.
This integration is not officially affiliated with Powershop. Use at your own risk, I just wanted to have my rate data available in HA, reached out to Powershop to ask for API access but was nothing available so built my own.
