Known Issues

Issues we are aware of and their workarounds.

Email verification (MFA) and 24-hour sessions

Since November 5, 2026, the Hydro-Québec customer portal requires an email verification code for every new session.

Resolved since version 0.9.0. The integration now shows the Email verification step during initial setup, reconfiguration and reauthentication. Enter the code you received; an empty field requests a new code.

The portal session lasts about 24 hours. During that time, Home Assistant restarts reuse the session without a password or code. After that, Home Assistant shows Reauthentication required in Settings → Devices & services: click Reauthenticate and enter the new code.

Automatic logins never request a code: they stop at the verification step and wait for a reauthentication. See Email verification.

Consumption does not sync

Occasional issue

During the start or end of the billing period, consumption is not available in the portal, so HydroQC is unable to retrieve it. Wait two or three days after the start of your billing period and consumption should start syncing again on its own.

Long-term history does not sync

When the integration has been running for a while, the consumption history import can stop responding. If you plan to import your long-term historical data, restart Home Assistant before running the import.

Errors in the logs from time to time

Hydro-Québec often performs maintenance on their systems which results in errors in HydroQC clients. If your installation is generally functional but you see errors in the logs from time to time, there’s no need to worry.

binascii.Error: Incorrect padding error

We have had a report of this issue. The problem comes from the Hydro-Québec client portal returning malformed JSON when the person’s name contains special characters (for example Benoît). The solution is to modify the name in the client portal.

  • Log in to your Hydro-Québec client portal

  • Move your cursor over your name in the top right

  • Click on “Login Information” (Identification Data)

  • Change your full name to remove all accented characters

Try again.