Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Aug 9, 2025
Merged

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

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
d5725b0
Update troubleshooting section
astrandb May 13, 2025
1cb6989
Merge remote-tracking branch 'upstream/current' into current
astrandb Aug 8, 2025
85236d4
Clarify the need for application credentials for Miele integration
astrandb Aug 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 15 additions & 11 deletions source/_integrations/miele.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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" %}

Expand All @@ -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

Expand Down Expand Up @@ -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.
Expand Down