Clarify how and when to enter applicaion credentials in Miele integration (#40342)

astrandb · web-flow · commit d81be7bdf147 · 2025-08-09T07:09:25.000+02:00
diff --git a/source/_integrations/miele.markdown b/source/_integrations/miele.markdown
@@ -59,16 +59,7 @@ Endpoints for the new generations are not yet available and will be released in
 
 ## Prerequisites
 
-{% details "Manual entry of authentication credentials" %}
-
-- Visit [https://www.miele.com/developer](https://www.miele.com/f/com/en/register_api.aspx) and sign up for a developer account.
-- Enter an arbitrary name for your connection and the email of your login for the original Miele app.
-- On success, you will get an email with an activation link. Press the **Activate** button. Make note of the client ID and secret - you will need them for the next step.
-You may be prompted to create an [Application - The provided Miele User Account email address must be all lowercase; otherwise, it will result in authentication failures.
-- The password should not contain any special characters. Even though it works in the Miele app, it may not work with the API.
-- Allow a couple of minutes to get the activation email. All changes in the developer portal take a couple of minutes before the change is implemented. Save your credentials as you will need them later.
-
-{% enddetails %}
+Make sure that you have your username, password, and country available for your Miele account.
 
 {% details "I have manually disabled My Home Assistant" %}
 
@@ -85,7 +76,7 @@ Internal examples: `http://192.168.0.2:8123/auth/external/callback`, `http://hom
 
 {% include integrations/config_flow.md %}
 
-The integration configuration may ask for the *Client ID* and *Client Secret* created above. See [Application Credentials](/integrations/application_credentials) for more details.
+The integration configuration may ask for *Client ID* and *Client Secret*. See [Troubleshooting](/integrations/miele/#troubleshooting) below and [Application Credentials](/integrations/application_credentials) for more details.
 
 ## Supported functionality
 
@@ -280,6 +271,19 @@ When the configuration entry is loaded or after a streaming error (for example a
 
 ## Troubleshooting
 
+{% details "Manual entry of authentication credentials" %}
+
+Follow these instructions if you are instructed to do so by a developer or by Miele support. It is not needed for normal use of the integration.
+
+- Visit [https://www.miele.com/developer](https://www.miele.com/f/com/en/register_api.aspx) and sign up for a developer account.
+- Enter an arbitrary name for your connection and the email of your login for the original Miele app.
+- On success, you will get an email with an activation link. Press the **Activate** button. Make note of the client ID and secret - you will need them for the next step.
+You may be prompted to create an [Application - The provided Miele User Account email address must be all lowercase; otherwise, it will result in authentication failures.
+- The password should not contain any special characters. Even though it works in the Miele app, it may not work with the API.
+- Allow a couple of minutes to get the activation email. All changes in the developer portal take a couple of minutes before the change is implemented. Save your credentials as you will need them later.
+
+{% enddetails %}
+
 {% details "Problem: Unavailable entities for a device" %}
 
 After reloading the Miele integration, the entities related to an appliance that used to be available are no longer available.
