Created At
Sep 12, 2023
Home Connect (Bosch/Siemens)
Created By Joep Verhaeg
Control Bosch/Siemens appliances via their Home Control ecosystem
Last Update
Jun 06, 2025
Platforms
HC 3 Lite, Yubii Home Pro, Yubii Home, HC 3
Views
5444
Download
537
Type Quick App
Basic Lua scene programming experience needed to use this Quick App due to the variety of appliances and large number of options that are possible within the Home Connect ecosystem.
Updates
- Version 0.7.0 (June 2025): fixed show appliances info table bug.
Preface
The HC3 does not support the programming of buttons and labels in child devices from the master QA. That's why this Quick App does not create child devices for your Bosch/Siemens appliances connected to Home Connect. This Quick App is made for automating your devices with Lua scenes, not as a user interface for your devices in the Yubii app.
Installation and usage
Full documentation with screenshots and examples is available on my website:
https://docs.joepverhaeg.nl/homeconnect/
The Quick App is still under development and the latest information will be available on my website and the official FIBARO forum.
Quick Start (to show possibilities)
Please read the tutorial for clear usage instructions!
Live updates
The Home Connect API uses Server Sent Events to get a stream of events for all appliances. The Server Sent Events push technology is not supported by the HC3! As a result, it is not possible to receive live status updates from your devices!
Manual updates
You can manually request the status of a device via a Lua scene. In theory you can schedule a refresh, but then you will quickly hit the API limits! You can retrieve a status update for an appliance and save the response in a Global Variable. This allows you to read the latest appliance status and use it in scenes.
hub.call(qaId, "getCurrentStatus", "SIEMENS-HCS03WCH1-A0AAAAAAA000", "MyApplianceStatus")
Control an appliance:
I wrote a helper function to get the scene code to start a specific program with the correct options selected on the psychical appliance.
If you select the program with the correct options on the device, you can use this function to generate the code to use in scenes:
hub.call(qaId, "getSelectedApplianceProgram", "SIEMENS-HCS03WCH1-A0AAAAAAA000")
And it outputs the full code you can use in a scene:
hub.call(421, 'controlAppliance', 'SIEMENS-HCS03WCH1-A0AAAAAAA000', '{ "data": { "key": "LaundryCare.Washer.Program.Cotton", "options": [ { "key": "LaundryCare.Washer.Option.Temperature", "value": "LaundryCare.Washer.EnumType.Temperature.GC30", "unit": "enum" }, { "key": "LaundryCare.Washer.Option.SpinSpeed", "value": "LaundryCare.Washer.EnumType.SpinSpeed.RPM1200", "unit": "enum" } ] } }')
Of course, an advanced user can create scenes themselves with the help of the Home Connect documentation.
Please read the full documentation with screenshots and examples on my website:
https://docs.joepverhaeg.nl/homeconnect/ before asking questions in the comments!
20 Comments, Want to add comment please login
I read that other integrations had to log in again due to changes on the Home Connect side. So I would remove the token from the Quick App variables in the Quick App so that you can authenticate again.
More info on the debug : [TRACE] [HOME CONNECT]: {"headers":{"www-authenticate":"Bearer realm=\"\", error=\"invalid_token\",error_description=\"The access token expired\"","strict-transport-security":"max-age=31536000; includeSubDomains; preload","access-control-allow-headers":"Authorization,Content-Type,Accept,Cache-Control,Last-Event-ID,If-Modified-Since,X-Requested-With,X-Events-Facade,User-Agent","ETag":"W\/\"5e-47FvRGQVGHcz4jZLaS+VycKpCiY\"","hc-env":"apigw","access-control-allow-credentials":"true","Date":"Sat, 16 May 2026 07:52:07 GMT","x-xss-protection":"1; mode=block","access-control-allow-origin":"*","x-frame-options":"sameorigin","api-gateway-service":"api-gateway","Content-Type":"application\/vnd.bsh.sdk.v1+json; charset=utf-8","Content-Length":"94","x-content-type-options":"nosniff","Connection":"close","referrer-policy":"origin","access-control-allow-methods":"GET,POST,OPTIONS,PUT,DELETE"},"data":"","status":401}
Hello Joep, I have noticed soince 10 days that the QA doesn't connect to the API anymore. I get this every few minutes : [ERROR] [HOME CONNECT]: Could not refresh the Home Connect API access token! and then when clicking on "reload appliances" I get [ERROR] [HOME CONNECT]: Could not retrieve the configured appliances. Error code: 401 --> Do I need to go and change my API access credentials or is there an issue with the API lately ? thanks. Felix
Did you authorize the correct scope? And filled in the correct scope in the QA? I think there is your problem.
You were right, deleting variable values of TokenExpiryTime, AccessToken and RefreshToken, then using the QA WebView to authenticate again through the API on the AUTHENTICATION URL (https://api.home-connect.com/security/oauth/device_verify?user_code=xxxxxxx) did the trick. Thanks for the tip