Created At

Apr 25, 2022

Last Update

May 31, 2023


HC 3 Lite, Z-box Hub, Yubii Home Pro, Yubii Home, HC 3





Type Quick App

Terms and conditions

This Somfy TaHoma Switch Quick App is for personal, non-commercial use only! You may not directly or indirectly sell, lease, loan or generate a revenue using this Somfy TaHoma Switch Quick App.

If you are an FIBARO Installer or personal user who wants to sell or use a supported Somfy TaHoma Quick App you can find the official supported integration here. This integration has both RTS and IO (2-way communication) support.


This Quick App has been written in such a way that it respects the Somfy API guidelines. Your use of the Somfy TaHoma switch Quick App is solely at your own risk. If your public IP address is blocked by the Somfy API servers, that is your own responsibility. If Somfy changes or stops offering the API that this Quick App uses, I will not be responsible for the failure of automations made with this Quick App.

Release notes


  • Somfy Cloud API server fix.


  • Quick fix for non responding roller shutters after May 17, 2023.


  • Token expiry issue solved. After two attempts the QA stops trying and logs back in after 1 minute.


  • Issue with RTS devices not responding to the open and my command fixed.


This Quick App reads the Somfy devices from the TaHoma switch box and creates child devices with the com.fibaro.rollerShutter device type. This allows you to control the devices in almost the same way the Roller Shutter 3 Z-wave module does.


The standard open, close and level commands are supported. Automatically the Favorite Position button is mapped to the My button on the Somfy system.

Device status

Most Somfy devices are not capable of reporting their status. Devices that use the IO protocol are capable but at the moment this is not implemented in this Quick App. You need to be aware of this when creating scenes with the HC3. The official supported integration supports both RTS and IO (2-way communication).

Quick installation


Before you can integrate your Somfy devices into the Home Center 3 (HC3) you must meet the following prerequisites:

  1. A TaHoma switch,
  2. Your Somfy devices needs to be configured and connected to the TaHoma switch via the TaHoma app,
  3. This Somfy TaHoma Quick App installed on your HC3.

Quick App installation

  1. Start your favorite browser and open your Home Center 3 dashboard by typing the correct URL for your HC3,
  2. Go to Settings and Devices,
  3. Click the blue + icon to add a new device,
  4. In the Add Device dialog click on Other Device,
  5. Choose Upload File and upload the .fqa file your can download below.
  6. Additionally you can change the icon of the Quick App with the attached icon.

Quick App configuration

  1. Go to Settings and Devices,
  2. Expand the imported Tahoma Switch device,
  3. Select the Variables tab,
  4. Fill in the userid and userPassword fields with the credentials you use to login the TaHoma app on your phone or tablet.
  5. If you press the blue Save button the Quick App will be initialised, reads all devices from the TaHoma box and automatically creates child devices in your HC3.


Full documentation

You can read the full documentation of the Somfy TaHoma Switch Quick App at:

53 Comments,  Want to add comment please login

Nach mehrmaliger Passwortänderung und Neustart läuft es jetzt. Aber ohne Sonnensensoren und Öffnungssensoren


Developer mode has nothing to do with this QA. This uses an old undocumented API and therefore its not maintained and supported anymore. Error 401 is an authentication error. Wrong username and/or password. As noted before some passwords with special chars don’t work.


Can anyone help me? This is what I get: {"data":"{\"errorCod","headers":{"Date":"Fri, 19 Jan 2024 15:09:04 GMT","Cache-Control":"no-cache, no-store, max-age=0, must-revalidate","Strict-Transport-Security":"max-age=31536000 ; includeSubDomains","X-XSS-Protection":"1; mode=block","X-Frame-Options":"DENY","X-Content-Type-Options":"nosniff","Vary":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers","Transfer-Encoding":"chunked","Pragma":"no-cache","Expires":"0","Server":"overkiz","Content-Type":"application\/json;charset=UTF-8"},"status":401} [19.01.2024] [16:09:05] [ERROR] [QUICKAPP1850]: QuickApp crashed I changed the password, I´ve activated the api, box was restarted, ist doesn´t work. It´s a Tahoma switch. With the older Tahoma Premium I could use the QA...


Thank you very much Joep Verhaeg, it was effectively an issue with special caracters on my password, all is working fine. Thanks for your job. Regards


@Sadegh: you get an authentication error. If you are sure the password is correct then make a new password at Somfy without special chars like & in it. This is a know bug in this QA, but I don’t maintain it anymore since the local API QA is online, but then it should work.

© 2024. Nice-Polska Sp. z o.o.Privacy policyTerms & ConditionsFeedback