Request: App for LVI / Purmo Clevertouch (API details inside!)

Apps
,
1

Hello everyone,

I would like to request an app for the LVI / Purmo Clevertouch E3 radiators.

With the help of an assistant, I have done a lot of research into the API and I believe all the necessary information to build an app is now available. We have determined that a simple HomeyScript is not enough because the login process seems to be a multi-step flow that requires cookie handling.

Here is the information we found by reverse-engineering the web portal:

Authentication Endpoint (POST): https://auth.e3.lvi.eu/realms/purmo/protocol/openid-connect/token

Form Data:

  • client_id: web

  • grant_type: password

  • username: (the user's email)

  • password: (the user's password)

Required Request Headers:

  • Origin: https://e3.lvi.eu

  • Referer: https://e3.lvi.eu/

  • Content-Type: application/x-www-form-urlencoded

  • (And a full set of browser-like headers, as a simple request was rejected with a 401 “invalid_client” error).

I hope this information is useful for any developer willing to take on this project. It seems very close to a solution!

Thank you!

2

Welcome Kristoffer,

There’s a system in place for that :grimacing:
You can add app requests here

or here

3

I have the same system at home. It took me about a month to make my own Homey app for this. But it is in an early stage. I can raise and lower the temperature and read the temperature from each device. And it has been working now for more than 3 months. I have some small fixes I haven’t managed to do yet, like being able to turn off all devices and fixing the login box to work (I have entered my user details in the code right now)

4

Hi everyone,
Following up on this thread — I built a working Homey app for LVI / Purmo Clevertouch (Touch E3) radiators, using the same account API discussed here. Sharing the source in case it’s useful to others until (or instead of) an official App Store release.
What it does:
Logs in with your CleverTouch account (email + password)
Lists all your rooms/radiators for pairing
Reads current temperature and target temperature per room
Lets you switch between Comfort, Eco, Frost guard, Boost (2h), Program, and Off
Polls every 3 minutes, plus a quick follow-up poll after any change
Known limitations:
Weekly schedules (the day/time program editor) can’t be read or edited from Homey — you can only activate “Program” mode as a whole
While in Program mode, the displayed target temperature only updates when the schedule itself switches between Eco/Comfort periods, not instantly — this is a limitation in LVI’s own API, not the app
No official App Store listing yet — install via Homey CLI (homey app run or homey app install)
Confirmed API details (in case useful for other projects):
Auth: POST ``https://auth.e3.lvi.eu/realms/purmo/protocol/openid-connect/token, client_id=app-front, grant_type=password
Data: POST ``https://e3.lvi.eu/api/v0.1/human/user/read/, .../smarthome/read/, .../query/push/ (form-encoded, Bearer token)
Temperatures are sent/received as FahrenheitĂ—10 despite the UI showing Celsius
Each mode has its own gv_mode/nv_mode pair and its own consigne_* preset field (see README for the full table)
Source code + full README with setup instructions:GitHub - fredrik402-ship-it/Homey-LVI-Clevertouch: App for Homey. LVI radiators in Homey (Clevertouch) · GitHub
Happy to hear if this works for others, and open to pull requests if anyone wants to help figure out weekly schedule support.