Configuration EN

Configuration

Sprache: English · Deutsch

This integration is configured entirely through the Home Assistant UI. No YAML configuration is needed.

Step 1 — Create a Husqvarna Application

Before configuring the integration, you need an application on the Husqvarna Developer Portal to obtain API credentials.

1. Go to the Husqvarna Developer Portal and create an account, or sign in with your existing Husqvarna account.
2. Navigate to My Applications and click Create Application.
3. Give it a name (e.g. Home Assistant) and set the redirect URI to https://localhost.
4. Under Connected APIs, enable the APIs you want to use:
   • Gardena Smart System API — for Gardena sensors, valves, power sockets, and SILENO mowers.
   • Automower Connect API — for Husqvarna Automower robotic mowers.
   • You can enable both on the same application.
5. Note the Application Key (Client ID) and Application Secret — both are required during setup in Home Assistant.

Tip: Use a dedicated application for Home Assistant. Each application has its own ~10,000 requests/month quota. Sharing one application between multiple smart-home platforms makes the budget tracking inaccurate. See API Rate Limits.

Step 2 — Add the Integration in Home Assistant

1. Go to Settings → Devices & Services → Add Integration.
2. Search for Gardena Smart System and select it.
3. Enter your Application Key (Client ID) and Application Secret from the Husqvarna Developer Portal.
4. Select the API you want to connect:
   • Gardena Smart System — for Gardena devices (sensors, valves, power sockets, SILENO mowers).
   • Automower Connect — for Husqvarna Automower robotic mowers.
5. For the Gardena Smart System API: if your account has multiple gardens (locations), you will be prompted to select which one to add. With a single garden, it is selected automatically.
6. For the Automower Connect API: all mowers linked to your Husqvarna account are discovered automatically.

Using Both APIs

To use both Gardena and Automower devices, add the integration twice — once selecting Gardena Smart System and once selecting Automower Connect. Both can use the same application credentials.

Re-authentication

If your credentials expire or become invalid, Home Assistant will prompt you to re-authenticate.

1. Open the integration page.
2. Click Reconfigure.
3. Enter your updated credentials.

Important: When you rotate the Husqvarna application (new Client ID), the API budget counter is reset on reauth/reconfigure so the budget sensor matches the fresh server-side quota. A simple secret refresh on the same Client ID preserves the counter.

MQTT Bridge (optional)

The integration can mirror device states to a local MQTT broker. See the MQTT Bridge page for details.

---

Next: Supported Devices