-
Notifications
You must be signed in to change notification settings - Fork 0
Configuration
- Go to Settings → Devices & Services → Add Integration
- Search for Sunsynk and click it
- Fill in the setup form:
| Field | Description |
|---|---|
| API Server |
api.sunsynk.net for Sunsynk inverters, pv.inteless.com for Deye / Inteless inverters |
| Your Sunsynk (or Deye) account email address | |
| Password | Your account password. MFA accounts are not supported — disable MFA before setup. |
| Inverter Serial Number(s) | Your inverter serial number. For multiple inverters, separate with semicolons: SN123456;SN789012
|
| Refresh Interval (seconds) | How often to poll the API. Default: 300 (5 minutes). Minimum: 60. The Sunsynk cloud itself updates every ~5 minutes, so polling faster has no real benefit. |
- Click Submit. The integration will validate your credentials and create a device entry for each serial number.
- Sunsynk app: tap your inverter → About → Serial Number
- Sunsynk web portal: home.sunsynk.net → your plant → the serial is visible in the URL and device info
- Physical inverter: label on the side of the inverter unit
Enter all serial numbers in a single field, separated by semicolons with no spaces:
SN123456;SN789012;SN345678
Each serial creates a separate device in Home Assistant. All devices share the same polling coordinator — they are all fetched together in each refresh cycle.
To change settings after initial setup:
Settings → Devices & Services → Sunsynk → Configure
You can change:
- Inverter Serial Number(s) — add or remove inverters
- Refresh Interval — adjust polling frequency
- Solar Forecast fields — enable or disable predicted yield sensors (see Solar Forecast)
- Tariff Manager fields — configure automatic charging/discharging based on electricity price (see Tariff Manager)
Saving options triggers a full reload of the integration (all entities briefly become unavailable during reload).
Settings → Devices & Services → Sunsynk → (⋮) → Delete
This removes all entities and devices. Your HA history data is preserved. The auto-generated Lovelace dashboard is NOT automatically removed — delete it manually from Settings → Dashboards if needed.
| Inverter brand | API server |
|---|---|
| Sunsynk | api.sunsynk.net |
| Deye (sold as Deye, Sunsynk outside SA) | pv.inteless.com |
| Sol-Ark, Turbo-Energy, Uitplus, Sofar | Try pv.inteless.com first |
If you are unsure, check which URL the official app uses when you log in — the login screen usually states the endpoint, or check the network requests in your browser developer tools.
The Sunsynk API uses RSA-encrypted login followed by an OAuth2 bearer token. The integration handles token caching and automatic refresh — you only need to enter your credentials once. Tokens are stored in memory and refreshed automatically when they expire; credentials are stored in the HA config entry (encrypted at rest by HA's credential store).