Automatic hydraulic balancing
- Efficiency for your heating system
More flexibility for the smart home: The Connect API of the Home Control Unit
The Connect API of the Homematic IP Home Control Unit makes your smart home installation more open and flexible than ever before. The free interface offers developers and system integrators a wide range of options for adapting a Homematic IP installation to their individual requirements.
Whether plugins run directly on the control panel or externally in the network: you always retain full control. The local WebSocket communication ensures that all processes run quickly and securely.
Experience how your Home Control Unit takes on a wide range of tasks - in your smart home as well as in office buildings, medical practices or hotels.
To get started, you can find detailed documentation and practical examples on GitHub.
The path to your own plugin
With the Connect API, you can design your Homematic IP installation exactly as you want it. The path to your own plugin is clearly structured:
Read the documentation
Use the extensive API documentation and example projects on GitHub to quickly familiarize yourself with the possibilities and functionality of the Connect API.
- DRAFT available
Activate developer mode
Put your Home Control Unit into developer mode. Only in this mode it is possible to install your own plugins or connect external applications in the local network.
- From the end of May 2025
Develop
plugin
The Connect API opens up various ways of integration: locally on the Home Control Unit or externally in the local network, connected via a secure WebSocket interface.
- From the end of May 2025
Important: The developer mode offers extended functionalities, but also contains risks. Therefore eQ-3 cannot offer technical support for devices in developer mode. Our mandatory liability remains unaffected. Switching back to regular operation is only possible by performing a factory reset or importing a backup. Therefore, create a backup before activating the developer mode.
The path to your own plugin
With the Connect API, you can design your Homematic IP installation exactly as you want it. The path to your own plugin is clearly structured:
Read the documentation
Use the extensive API documentation and example projects on GitHub to quickly familiarize yourself with the possibilities and functionality of the Connect API.
- DRAFT available
Activate developer mode
Put your Home Control Unit into developer mode. Only in this mode it is possible to install your own plugins or connect external applications in the local network.
- From the end of May 2025
Develop plugin
The Connect API opens up various ways of integration: locally on the Home Control Unit or externally in the local network, connected via a secure WebSocket interface.
- From the end of May 2025
Important: The developer mode offers extended functionalities, but also contains risks. Therefore eQ-3 cannot offer technical support for devices in developer mode. Our mandatory liability remains unaffected. Switching back to regular operation is only possible by performing a factory reset or importing a backup. Therefore, create a backup before activating the developer mode.
FAQs
Where can I find the Homematic IP Connect API documentation?
The documentation is provided via GitHub available at the following URL: https://github.com/homematicip
Note: The documentation is currently available as a draft. Subsequent changes are possible at any time.
How can I activate the developer mode of the Home Control Unit?
Developer mode is activated in the HCUWeb. Attention: eQ-3 does not provide technical support for devices with activated developer mode! Once developer mode has been fully activated, it can only be exited by resetting the Home Control Unit to factory settings or importing a backup! Therefore, create a backup before activating developer mode.
Where can I download plugins?
The Homematic IP Home Control Unit is supplied with three pre-installed plugins (CCU3, Philips Hue, EEBus). These can be activated via the WebUI of the control unit. In addition, eQ-3 does not yet offer any certified plugins for download. This is planned for the future. The use of non-certified plugins is without support and at your own risk.
Open. Flexible. Future-proof.
The Homematic IP Home Control Unit impresses with its open architecture, which enables a wide range of integrations - for end customers as well as for professional partners in the B2B sector. In addition to Homematic IP devices, solutions such as Philips Hue, EEBus or individual partner plugins can also be integrated via standardized interfaces. This creates tailor-made smart home and building automation solutions that meet the highest standards of convenience, efficiency and future-proofing.
