External integration - Overkiz: Multiple accounts

Configuration
1

Hello @cicoub13,

First of all, thank you for this integration :slight_smile:. On my side, I have both a Somfy Connectivity Kit (for my RTS shutters) and a Thermor water heater. What would be the best way to support this use case?

  • Deploy 2x the integration (one per account)
  • Support multiple accounts in the same integration

At HA, there is the notion of a Hub:

Screenshot 2026-08-15 at 16.13.40
Screenshot 2026-08-15 at 16.13.40994×800 26.1 KB

Thanks again.

David.

2

Hi, I’m studying the case :sweat_smile:

3

I have a multi-account test version.
If you’re comfortable with the idea of testing, you need to:

  • uninstall the Overkiz integration
  • click the blue Install from Github button
  • click Developer mode
  • specify this image ghcr.io/cicoub13/gladys-overkiz:feat-multi-account
  • paste the manifest (content of this file)
  • Install

You will be able to configure up to three accounts :star_struck:

Capture d’écran 2026-08-16 à 15.39.45
Capture d’écran 2026-08-16 à 15.39.451732×1584 292 KB

If everything works well, I’ll make a public version

4

Will those who update be affected when the update is released, or will it be transparent?

5

The configuration of the current version 1.2.0 is compatible (the account will go into the first slot). However, if you are playing with the test version, you will need to remove the integration (and thus lose all devices and configurations).

6

I only have one Overkitz account ^^ thanks for the feedback

7

Hello @cicoub13 ,

Thanks for this test version. After my request, the least I can do is to test it :wink: .

I configured my 2 accounts. Once the registration is done, here is the message when I click on the first button « Test the connection Â» :

Account 1 (Atlantic Cozytouch): Connection to the Overkiz API failed: this.externalId is not a function · Account 2 (Somfy Europe): Connection to the Overkiz API failed: this.externalId is not a function / Account 1 (Atlantic Cozytouch): Connection to the Overkiz API failed: this.externalId is not a function · Account 2 (Somfy Europe): Connection to the Overkiz API failed: this.externalId is not a function

Below, on listing the raw devices, here is the message :

11 device(s) written in the integration logs (Account 1 (Atlantic Cozytouch): 4 · Account 2 (Somfy Europe): 7). They contain the serial number of your box: anonymize them before sharing them.

Nothing is found for the scan in discovery.

Here are the full logs (which I have anonymized):

[2026-08-16T14:13:14.990Z] [INFO] Starting the Overkiz integration..
8

Thanks for the test, it’s fixed. Can you delete and reinstall using the same procedure?

9

Hello @cicoub13,

Everything seems OK on my end:

Connection OK — supported devices by account: Account 1 (Atlantic Cozytouch): 2 · Account 2 (Somfy Europe): 4.

And I can see all my devices (roller shutters and water heaters) in the discovery :slight_smile:

Great.

Thanks again for the update.
David

10

It’s merged and published in version 1.4.0 :tada:
Thanks for the tests :folded_hands: