myGEKKO HomeConnect

Gateway • REST-API (DDF)

myGEKKO
Download Signed DDF
Device image

Basic integration, e.g., to get a door status. This serves only as a template and should not be seen as a complete integration.

Quick Guide: Creating a Home Connect App

  1. Access the Developer Portal
    Go to the Home Connect Developer Portal and log in or create a new account.
  2. Register Application
    Navigate to the Applications section and click on Register Application .
  3. Enter Data
    Fill in the fields with the following details:
    • Application ID: Assign a descriptive name for your application or your customer's application (e.g., "Controller Mustermann").
    • OAuth Flow: Select "Authorization Code Grant Flow" from the dropdown menu.
    • Home Connect User Account for Testing: Enter the email address of the customer's Home Connect account or your own.
    • Redirect URI: Insert the exact URI below into the designated field: https://devicelib.my-gekko.com/OAuth.php
  4. Save
    Save the configuration. After saving, a Client ID and a Client Secret will be displayed.
    Important: Keep these two values secure, as they are required for authenticating your application.

Device Station settings

  • Domain:
    • https://api.home-connect.com (Real devices)
    • https://simulator.home-connect.com (For simulators)
  • Client ID: ???????????????????
  • Client Secret: ???????????????
  • Redirect URI: https://devicelib.my-gekko.com/OAuth.php
  1. Command AUTHORIZE → click the URL and sign in.
  2. Command GETAPPLIANCES
Manufacturer Type Protocol Model Version ID
myGEKKO Gateway REST-API (DDF) 2 1 0x0D00000100020100
No documents.
ID Name Unit Type Direction
0 Name
1 Type
2 Id
10 Doorstate Closed/Open
11 SETTEMPERATUR C
12 SETPROGRAMM C
100 POLLTOKEN
101 REFRESHTOKEN
103 GETEVENTS
150 EXPIRES_IN
151 EXPIRES_DATE
152 EXPIRES_REST
153 SLAVE
*2026-03-09 08:04:02 (hw) ******************************
Last Commit: d8ed604d | 2026-02-26 09:32:52