A custom Home Assistant integration that enables multiple YoLink homes using User Access Credentials (UAC) authentication.
The official YoLink integration only supports a single home per Home Assistant instance. If you have multiple YoLink homes (e.g., primary residence and vacation home), you cannot access devices from both homes simultaneously.
This custom integration solves that limitation by using YoLink's UAC (User Access Credentials) authentication instead of OAuth2, where each UAC is tied to a specific home.
✅ Multiple YoLink Homes - Configure as many YoLink homes as you need ✅ UAC Authentication - Simple credential-based setup (no OAuth2 flow) ✅ Full Device Support - All device types supported by the official integration ✅ Coexists with Official Integration - Can run alongside the official YoLink integration ✅ Auto-Discovery - Devices automatically discovered and organized by home ✅ MQTT Push Updates - Real-time device state updates
This integration supports the same devices as the official YoLink integration:
- Door/Contact Sensors
- Motion Sensors
- Temperature & Humidity Sensors
- Water Leak Sensors
- Smart Locks
- Smart Switches & Outlets
- Garage Door Controllers
- Sirens & Alarms
- Thermostats
- And more...
- Install HACS if you haven't already: https://hacs.xyz/docs/setup/download
- Add this repository as a custom repository:
- Open HACS
- Click on "Integrations"
- Click the three dots in the top right
- Select "Custom repositories"
- Enter the URL:
https://github.com/cd1zz/homeassistant-yolink-multi - Category: "Integration"
- Click "Add"
- Install the integration:
- Find "YoLink Multi-Home" in HACS
- Click "Download"
- Restart Home Assistant
- Download this repository
- Copy the
custom_components/yolink_multidirectory to your Home Assistantconfig/custom_components/directory - Restart Home Assistant
You need to create User Access Credentials (UAC) for each home you want to add:
- Open the YoLink mobile app
- Navigate to: [Account] → [Advanced Settings] → [Personal Access Credentials]
- Tap the [+] button to create new credentials
- Important: Make sure you're viewing the home you want to add BEFORE creating credentials
- Switch homes using the home selector if needed
- Copy the UAID (User Access ID) and Secret Key
- Repeat for each additional home
Important: Each UAC is tied to ONE home. If you have 2 homes, you need 2 sets of credentials.
Reference: Official YoLink UAC Documentation
- Go to Settings → Devices & Services
- Click "+ Add Integration"
- Search for "YoLink Multi-Home"
- Enter your UAID and Secret Key from Step 1
- Click Submit
- Your devices will be automatically discovered
To add another YoLink home:
- Repeat Step 1 to get UAC credentials for your second home
- In Home Assistant, go to Settings → Devices & Services
- Click "+ Add Integration" again
- Search for "YoLink Multi-Home"
- Enter the credentials for your second home
- Both homes will now be available in Home Assistant!
Each config entry represents one YoLink home. Devices are uniquely identified using:
{home_id}_{device_id}
This prevents device ID conflicts when you have the same device types in multiple homes.
Devices are automatically suggested to be placed in an area matching your home name (e.g., "Vacation Home", "Main House"), making it easy to organize your devices.
This integration uses the domain yolink_multi, which is different from the official integration's yolink domain. This means:
- ✅ You can run both integrations simultaneously
- ✅ No conflicts with existing YoLink setup
- ✅ You could use OAuth2 for one home and UAC for another
| Feature | Official YoLink | YoLink Multi-Home |
|---|---|---|
| Authentication | OAuth2 | UAC (User Access Credentials) |
| Multiple Homes | ❌ Single home only | ✅ Unlimited homes |
| Setup Complexity | Medium (OAuth redirect) | Simple (copy/paste credentials) |
| Device Support | Full | Full (same codebase) |
| Domain | yolink |
yolink_multi |
- Verify your UAID and Secret Key are correct
- Ensure your YoLink account has access to the home
- Check your internet connection
- Try regenerating your UAC credentials
- Wait a few minutes for device discovery
- Check that the devices are assigned to the correct home in the YoLink app
- Try reloading the integration
You're trying to add the same home twice. Each home can only be added once.
If your credentials expire, Home Assistant will prompt you to reauthenticate:
- Go to Settings → Devices & Services
- Find the YoLink Multi-Home entry showing an error
- Click "Reauthenticate"
- Enter new UAC credentials for the same home
Q: Can I use this with the official YoLink integration? A: Yes! They use different domains and won't conflict.
Q: Do I need separate YoLink accounts? A: No! You use the same YoLink account. You just create different UAC credentials for each home.
Q: Will this work with YoLink hubs? A: Yes, it works with all YoLink hubs and devices.
Q: What happens if I delete a device from YoLink app? A: The device will be automatically removed from Home Assistant on the next refresh.
Q: Can I rename devices? A: Yes, you can rename devices in Home Assistant just like any other entity.
- Issues: https://github.com/cd1zz/homeassistant-yolink-multi/issues
- Home Assistant Community: https://community.home-assistant.io/
- YoLink Support: https://support.yosmart.com/
This integration is based on the official Home Assistant YoLink integration by @matrixd2.
Modifications:
- Added UAC authentication support
- Implemented multi-home functionality
- Updated device identifiers to support multiple homes
- Simplified configuration flow
Apache License 2.0 - See LICENSE for details.
This is a derivative work of the Home Assistant YoLink integration, licensed under Apache 2.0.