From 79abe0e615c09763d5ec3650787a1e454d34ac8b Mon Sep 17 00:00:00 2001 From: Andrej Walilko Date: Wed, 29 Apr 2026 12:13:30 -0400 Subject: [PATCH 1/5] update config flow for ecobee --- source/_integrations/ecobee.markdown | 69 ++++++---------------------- 1 file changed, 15 insertions(+), 54 deletions(-) diff --git a/source/_integrations/ecobee.markdown b/source/_integrations/ecobee.markdown index 3e0b8929982f..c81bdf5862d6 100644 --- a/source/_integrations/ecobee.markdown +++ b/source/_integrations/ecobee.markdown @@ -30,65 +30,26 @@ ha_integration_type: hub The **ecobee** {% term integration %} lets you control and view sensor data from [ecobee](https://ecobee.com) thermostats. -## Preliminary steps - -You will need to obtain an API key from ecobee's [developer site](https://www.ecobee.com/developers/) to use this integration. To get the key, your thermostat must be registered on ecobee's website (which you likely would have already done while installing your thermostat). Once you have done that, perform the following steps. - -{% warning %} -As of March 28th, 2024, ecobee is no longer accepting new developer subscriptions, nor are existing developer accounts able to create new API keys. There is no ETA for when they will be allowed again. Existing API keys will continue to function. - -In the meantime, you can use the [HomeKit Device](/integrations/homekit_controller/) integration as a fully functional alternative. -{% endwarning %} - -1. Click on the **Become a developer** link on the [developer site](https://www.ecobee.com/home/developer/loginDeveloper.jsp). -2. Log in with your ecobee credentials. (Make sure multifactor authentication is disabled to meet the developer login form's limits. If you've already enabled MFA, the web portal doesn't support disabling it. The iOS and Android apps do under Account > Account Security. You can re-enable MFA after becoming a developer.) -3. Accept the SDK agreement. -4. Fill in the fields. -5. Click **save**. - -Log in to the regular consumer portal and click the overflow menu button in the upper right. You will see a new option named **Developer**. Now an application can be created to integrate with Home Assistant. - -1. Select the **Developer** option from the hamburger menu on the top-right. -2. Select **Create New**. -3. Complete the form on the right. (Neither of the fields are referenced by Home Assistant) - - Name: Must be unique across all ecobee users. - - Summary: Does not need to be unique. -4. Click *Authorization method* and select **ecobee PIN**. -5. Click **Create**. - -Your new application will now appear on the left. Upon clicking on the application, API key will appear on the right. Copy this key and use it in the configuration section below. Click **X** to close the Developer section. - -## Configuration - -1. In the {% my integrations title="**Settings** > **Devices & services**" %} menu, click **+** and then select "ecobee" from the pop-up menu. -2. In the pop-up box, enter the API key you obtained from ecobee's [developer portal](https://ecobee.com/developers). -3. In the next pop-up box, you will be presented with a unique 8 character code separated by a dash (format: XXXX-XXXX), which you will need to authorize in the [ecobee consumer portal](https://www.ecobee.com/consumerportal/index.html). You can do this by logging in, selecting **My Apps** from the hamburger menu, clicking **Add Application** on the left, entering the PIN code from Home Assistant, clicking **Validate** and then **Add Application** in the bottom right. -4. After authorizing the app with ecobee, return to Home Assistant and click **Submit**. If the authorization was successful, a configuration entry will be created and your thermostats, ventilators and sensors will be available in Home Assistant. - -## Manual configuration - -If you prefer to set up the integration in your {% term "`configuration.yaml`" %} file, add your API key (and optional parameters) as follows (however, you must still complete authorization via the **Integrations** panel). -{% include integrations/restart_ha_after_config_inclusion.md %} - -```yaml -# Example configuration.yaml entry -ecobee: - api_key: YOUR_API_KEY -``` - -{% configuration %} -api_key: - description: Your ecobee API key. This is only needed for the initial setup of the integration. Once registered it can be removed. If you revoke the key in the ecobee portal, you will need to remove the existing `ecobee` configuration in the **Integrations** panel, update this, and then configure the integration again. - required: false - type: string -{% endconfiguration %} -

+

-You must [restart Home Assistant](/docs/configuration/#reloading-changes) for the changes to take effect. After restarting, go to {% my integrations title="**Settings** > **Devices & services**" %} and select the integration. Then, select **Configure** and continue to authorize the app according to the above **Automatic Configuration**, starting at step 2. +{% note %} +Since March 2026, it is no longer required to get a [developer API key](https://www.ecobee.com/developers/) to use this integration. Existing API keys will continue to function. If you revoke your existing key in the ecobee portal, you will need to remove the `ecobee` configuration in the Integrations panel, and then configure the integration again. +{% endnote %} + +{% include integrations/config_flow.md %} + +{% configuration_basic %} +API key: + description: If you have developer API key, use this field and ignore the others. **If you are logging in without an API key, leave this field blank, and use the others.** +username: + The email address you use to sign in to [ecobee.com](https://ecobee.com). +password: + The password for the above account. +{% endconfiguration_basic %} ## Notifications From eceab3c0be714d82866cae33c7fbdf8ffe491778 Mon Sep 17 00:00:00 2001 From: Andrej Walilko Date: Wed, 29 Apr 2026 12:21:40 -0400 Subject: [PATCH 2/5] syntax corrections --- source/_integrations/ecobee.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_integrations/ecobee.markdown b/source/_integrations/ecobee.markdown index c81bdf5862d6..a27c7607f42b 100644 --- a/source/_integrations/ecobee.markdown +++ b/source/_integrations/ecobee.markdown @@ -32,7 +32,7 @@ The **ecobee** {% term integration %} lets you control and view sensor data from

-
+

@@ -46,9 +46,9 @@ Since March 2026, it is no longer required to get a [developer API key](https:// API key: description: If you have developer API key, use this field and ignore the others. **If you are logging in without an API key, leave this field blank, and use the others.** username: - The email address you use to sign in to [ecobee.com](https://ecobee.com). + description: The email address you use to sign in to [ecobee.com](https://ecobee.com). password: - The password for the above account. + description: The password for the above account. {% endconfiguration_basic %} ## Notifications From 11e0c5e5996adda07d6f17389ac91969ed923af9 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Thu, 30 Apr 2026 10:01:47 +0200 Subject: [PATCH 3/5] tiny tweak --- source/_integrations/ecobee.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/ecobee.markdown b/source/_integrations/ecobee.markdown index a27c7607f42b..9c519e693008 100644 --- a/source/_integrations/ecobee.markdown +++ b/source/_integrations/ecobee.markdown @@ -44,7 +44,7 @@ Since March 2026, it is no longer required to get a [developer API key](https:// {% configuration_basic %} API key: - description: If you have developer API key, use this field and ignore the others. **If you are logging in without an API key, leave this field blank, and use the others.** + description: If you have a developer API key, use this field and ignore the others. If you are logging in without an API key, leave this field blank and use username and password. username: description: The email address you use to sign in to [ecobee.com](https://ecobee.com). password: From 3cf753b8ac0c4ba11e520e30e88948338b7be9fb Mon Sep 17 00:00:00 2001 From: Andrej Walilko Date: Thu, 30 Apr 2026 10:32:10 -0400 Subject: [PATCH 4/5] add prereq section --- source/_integrations/ecobee.markdown | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/source/_integrations/ecobee.markdown b/source/_integrations/ecobee.markdown index 9c519e693008..d53923d8ce98 100644 --- a/source/_integrations/ecobee.markdown +++ b/source/_integrations/ecobee.markdown @@ -36,8 +36,11 @@ The **ecobee** {% term integration %} lets you control and view sensor data from

+## Prerequisites +To set up the connection, you will need to have a username and password for [ecobee.com](https://ecobee.com). Set this up before adding the integration. You can add devices either before or after you configure the service in Home Assistant, but having them connected to your ecobee.com account ahead of time is recommended to confirm that they are picked up by the service correctly. + {% note %} -Since March 2026, it is no longer required to get a [developer API key](https://www.ecobee.com/developers/) to use this integration. Existing API keys will continue to function. If you revoke your existing key in the ecobee portal, you will need to remove the `ecobee` configuration in the Integrations panel, and then configure the integration again. +Since version 2026.3, it is no longer required to get a [developer API key](https://www.ecobee.com/developers/) to use this integration. Existing API keys will continue to function. If you revoke your existing key in the ecobee portal, the integraion will fail, and you will need to remove the service in Home Assistant and set it up again. {% endnote %} {% include integrations/config_flow.md %} From 4114b9fc0825eddfb3d672032f7605c7d6f897c9 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Mon, 4 May 2026 07:43:22 +0200 Subject: [PATCH 5/5] tweaks Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/ecobee.markdown | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/source/_integrations/ecobee.markdown b/source/_integrations/ecobee.markdown index d53923d8ce98..ad42b361821f 100644 --- a/source/_integrations/ecobee.markdown +++ b/source/_integrations/ecobee.markdown @@ -37,10 +37,14 @@ The **ecobee** {% term integration %} lets you control and view sensor data from

## Prerequisites -To set up the connection, you will need to have a username and password for [ecobee.com](https://ecobee.com). Set this up before adding the integration. You can add devices either before or after you configure the service in Home Assistant, but having them connected to your ecobee.com account ahead of time is recommended to confirm that they are picked up by the service correctly. + +- Username and password for [ecobee.com](https://ecobee.com). + - You will need it when adding the integration to set up a connection between the integration and Home Assistant. +- Have the devices connected to your ecobee.com account. + - You can add devices either before or after you configure the service in Home Assistant, but having them connected to your ecobee.com account ahead of time is recommended to confirm that they are picked up by the service correctly. {% note %} -Since version 2026.3, it is no longer required to get a [developer API key](https://www.ecobee.com/developers/) to use this integration. Existing API keys will continue to function. If you revoke your existing key in the ecobee portal, the integraion will fail, and you will need to remove the service in Home Assistant and set it up again. +Since version 2026.3, it is no longer required to get a [developer API key](https://www.ecobee.com/developers/) to use this integration. Existing API keys will continue to function. If you revoke your existing key in the ecobee portal, the integration will fail, and you will need to remove the service in Home Assistant and set it up again. {% endnote %} {% include integrations/config_flow.md %}