Hobby API

What is the hobby API?

By using the hobby API you can link smart solutions to your Niko Home Control installation yourself as well. You, as an advanced code-savvy-user, can make Niko Home Control work together with your own application or with solutions such as Node-RED, openHAB or Home Assistant.

Niko or your professional installer do not support applications or solutions you build with the hobby API. For support, Niko refers to the communities listed above.

What can you do with Niko Home Control?

By using Niko Home Control with the hobby API, you can do the following:

Retrieve your available Niko Home Control locations
Retrieve your available Niko Home Control actions and devices
Control your Niko Home Control actions and devices
Receive status information from your Niko Home Control actions and devices
Receive notification messages from your Niko Home Control installation

What do you need?

In short

Extra information

General

No additional electrical wiring is required.
You have a computer with a web browser and an internet connection.
You have knowledge of MQTT and JSON.
You are an advanced code-savvy user and you have a great idea.

Your Niko Home Control system meets the following requirements:

It has a wireless smart hub or a connected controller II.
It is configured with the most recent programming software (version 2.17 or higher).
It has an active internet connection.
It is registered and you have your e-mail address and password on hand.

If you have not registered your Niko Home Control installation, go to Register your installation.

The Hobby API is on your connected controller or wireless smart hub.
You have your JWT API access token.

If you have no token, request it via the Niko Home Control programming software. More information, see the software manual.

The access token needs a yearly renewal. You find the procedure here.

How do you set up the connection?

You set up the connection in the Niko Home Control programming software. Make sure your computer is connected to your installation and go to Dashboard > Connected services > Manage connected services.

You find the requirements and detailed instructions in the software manual.