Niko Home Control is evolving into MOTIV Building Control. MOTIV is a new brand for intelligent building automation. Built on the trusted foundation of Niko Home Control, MOTIV solutions are designed to make buildings work more naturally for the people inside them. MOTIV helps professionals create smarter, more comfortable buildings. With technology that works quietly in the background. All existing Niko Home Control solutions remain fully compatible with MOTIV. Over time, the full portfolio will move to the MOTIV brand. During this transition, you will see both Niko Home Control (NHC) and MOTIV Building Control (MBC) appear in this documentation. Discover MOTIV at niko.eu/MOTIV
Software Manual
Working version 2.27.1 English Dutch French Slovak Danish German Swedish
Software Manual
Working version 2.27.1 English Dutch French Slovak Danish German Swedish
Breadcrumbs

Hobby API

What is the hobby API?

By using the hobby API you can link smart solutions to your MOTIV Building Control installation yourself as well. You, as an advanced code-savvy-user, can make MOTIV Building 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, MOTIV refers to the communities listed above.

What can you do with MOTIV Building Control?

For an overview, see Connections to third-party systems > Hobby API.

What do you need?

Before proceeding with activation, please consult the requirements (general, MOTIV, and Hobby API); see Connections to third-party systems > Hobby API.

How do you get access to the hobby API (documentation and authentication)?

  1. Make sure you have everything you need (see above).

  2. Click on Dashboard.
    https://s3-eu-west-1.amazonaws.com/guideimages/Screenshots/V2.9/EN/s03_05_20_228_001.png

  3. Click on Manage connected services.
    https://s3-eu-west-1.amazonaws.com/guideimages/Screenshots/V2.9/EN/s03_05_20_228_002.png

  4. In the Additional steps required section, click the arrow next to the hobby API logo.
    https://s3-eu-west-1.amazonaws.com/guideimages/Screenshots/V2.9/EN/s03_05_20_228_003.png

  5. Click on Manage.

  6. If you are already logged in into MOTIV Building Control programming software, go to step 8. If not, proceed as follows.
    https://s3-eu-west-1.amazonaws.com/guideimages/Screenshots/V2.9/EN/s03_05_20_228_004.png

  7. Fill in your e-mail address and MOTIV account password.

  8. Click on Accept to agree with the terms & conditions.
    https://s3-eu-west-1.amazonaws.com/guideimages/Screenshots/V2.9/EN/s03_05_20_228_005.png

  9. Click on Copy to retrieve the token and use it in your application.

  10. Click on Done.


  • You can find the API documentation here.

  • You can't change the username in the activation window.


How do you renew the access token?

About the access token:

  • The token expires after a year.

  • The token needs a yearly renewal.

  • A renewal is possible at the earliest one month before the actual expiration date.

  • You are not informed by Niko that the token is about to expire. Tip: You can create a notification in the software. The Niko Home app will remind you to renew the token.

  1. Make sure you have everything you need (see above).

  2. Click on Dashboard.
    https://s3-eu-west-1.amazonaws.com/guideimages/Screenshots/V2.9/EN/s03_05_20_228_001.png

  3. Click on Manage connected services.
    https://s3-eu-west-1.amazonaws.com/guideimages/Screenshots/V2.9/EN/s03_05_20_228_002.png

  4. In the Additional steps required section, click the arrow next to the hobby API logo.
    https://s3-eu-west-1.amazonaws.com/guideimages/Screenshots/V2.9/EN/s03_05_20_228_003.png

  5. Click on Manage.
    https://s3-eu-west-1.amazonaws.com/guideimages/Screenshots/V2.9/EN/s03_05_20_228_004.png

  6. Follow the instructions on your screen to receive a new token.