home-assistant.io/source/_integrations/home_connect.markdown

title, description, logo, ha_category, ha_iot_class, ha_release, ha_domain, ha_codeowners, ha_config_flow, ha_platforms

title	description	logo	ha_category	ha_iot_class	ha_release	ha_domain	ha_codeowners	ha_config_flow	ha_platforms
Home Connect	Instructions on how to set up the Home Connect integration within Home Assistant.	homeconnect.png	Hub Binary Sensor Light Sensor Switch	Cloud Push	0.110	home_connect	@DavidMStraub	true	binary_sensor light sensor switch

The Home Connect integration allows users to integrate their home appliances supporting the Home Connect standard for Bosch and Siemens using the official cloud API.

The integration will add one Home Assistant device for each connected home appliance which will have the following entities:

• A power switch
• If the device has programs, switches for each of the individual programs will be added. Note that program options cannot be configured currently.
• If the device has programs, a timestamp sensor for remaining time and a numeric sensor for the progress percentage.
• For hood's functional light a light switch including brightness control will be added.
• For hood's and dishwasher's ambient light a light switch including brightness and color control will be added.

Note that it depends on the appliance and on API permissions which of the features are supported. A notable limitation is that oven programs cannot be started currently.

Prerequisites

1. Visit https://developer.home-connect.com and sign up for a developer account.
2. Enter the email of your login for the original Home Connect App from Bosch/Siemens under "Default Home Connect User Account for Testing" in the sign up process.
3. Under Applications, register a new App:

• Application ID: Home Assistant (or whatever name makes sense to you)
• OAuth Flow: Authorization Code Grant Flow
• Redirect URI: "<INTERNAL_HOME_ASSISTANT_URL>/auth/external/callback Use your internal Home Assistant URL, if you didn't configure one manually, use your local IP address. Examples: http://192.168.0.2:8123/auth/external/callback, http://homeassistant.local:8123/auth/external/callback."

Next, add the following to your configuration.yaml file:

# Example configuration.yaml entry

home_connect:
  client_id: CLIENT_ID
  client_secret: CLIENT_SECRET

{% configuration %} client_id: description: Your Home Connect client ID. required: true type: string client_secret: description: Your Home Connect client secret. required: true type: string {% endconfiguration %}

{% include integrations/config_flow.md %}