diff --git a/source/_integrations/vicare.markdown b/source/_integrations/vicare.markdown
index bdd639d6bbf..43b5a2d53c9 100644
--- a/source/_integrations/vicare.markdown
+++ b/source/_integrations/vicare.markdown
@@ -34,17 +34,16 @@ There is currently support for the following device types within Home Assistant:
 
 {% include integrations/config_flow.md %}
 
-Set `username`and `password` to your Viessmann Developer Portal login credentials.
-The required Client ID can be obtained as follows:
-1. Register and login in the [Viessmann Developer Portal](https://developer.viessmann.com). Use the same account as the one you registered your device with in ViCare.
-2. In the menu navigate to API Keys.
-3. Create a new OAuth client using the following data:
-  ```txt
-  Name: PyViCare
-  Google reCAPTCHA: Disabled
-  Redirect URIs: vicare://oauth-callback/everest
-  ```
-4. Copy the Client ID from the Viessmann portal and enter this in the API Key field in Home Assistant.
+Use your ViCare app login credentials for *username* and *password*.
+
+The required *client ID* can be obtained from the [Viessmann Developer Portal](https://app.developer.viessmann.com/):
+1. Log in with **your existing ViCare app username and password**.
+2. On the developer dashboard, select **Add** in the **Clients** section.
+3. Create a new client using the following data:
+   - Name: `HomeAssistant`
+   - Google reCAPTCHA: Disabled
+   - Redirect URIs: `vicare://oauth-callback/everest`
+4. Find the **Client ID** in the **Clients** section on the developer dashboard.
 
 The `heating_type` can either be `auto` to automatically find the most suitable type for your device or one of `gas`, `oil`, `pellets`, `heatpump`, `fuelcell`, `hybrid`.