LG ThinQ
The LG ThinQ integration allows you to connect LG ThinQ devices to Home Assistant. The features of this integration include:
- Control LG appliances as Home Assistant entities through the LG ThinQ Connect API.
Prerequisites
- This feature works via LG ThinQ cloud. Therefore, an internet connection is required.
- A personal access token
to use the LG ThinQ Connect API.
Personal Access Token (PAT)
- Access the personal access token
page (requires an LG ThinQ account). - Select ADD NEW TOKEN.
- Enter a new token name and select the following authorized scopes:
- Permission to view all devices
- Permission to view all device statuses
- All device control rights
- All device event subscription rights
- All device push notification permissions
- Select CREATE TOKEN.
- Once all the steps are completed, you will see that a PAT has been generated.
Configuration
To add the LG ThinQ integration to your Home Assistant instance, use this My button:
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select LG ThinQ.
-
Follow the instructions on screen to complete the setup.
- Enter the information to use LG ThinQ Connect API:
- The Token Value obtained through the PAT issuance process. (Required)
- The entry name.
- Choose the region (country).
Supported Devices
Appliance
Support LG Appliances as follows:
- Air Conditioner
- Air Purifier
- Air Purifier Fan
- Ceiling Fan
- Cooktop
- Dehumidifier
- Dishwasher
- Dryer
- Home Brew
- Hood
- Humidifier
- Kimchi Refrigerator
- Microwave Oven
- Oven
- Plant Cultivator
- Refrigerator
- Robot Cleaner
- Stick Cleaner
- Styler
- System Boiler
- Washcombo Main
- Washcombo Mini
- Washer
- Washtower
- Washtower Dryer
- Washtower Washer
- Water Heater
- Water Purifier
- Wine Cellar
Platforms
LG ThinQ represents devices as a set of properties. And these are mapped to entities in Home Assistant.
A list of all Entity Platforms provided by LG ThinQ Integration:
Binary sensor
A read-only property which has only two states that can be toggled is represented as a binary sensor platform.
| Device | Property |
|---|---|
| Cooktop | Remote start |
| Dish Washer | Chime sound Clean indicator light Door Machine clean reminder Remote start Rinse refill needed |
| Hood | Power |
| Oven | Remote start |
| Refrigerator | Door Eco friendly Power saving mode Sabbath |
| Kimchi Refrigerator | Fresh air filter |
| Dryer Styler Washer Washcombo Main Washcombo Mini Washtower Washtower Dryer Washtower Washer |
Remote start |
| Water Heater | Power |
| Wine Cellar | Sabbath |
Climate
The properties for controlling both the temperature and wind strength of the appliance are represented as a climate platform.
| Device | Property |
|---|---|
| Air Conditioner | Current temperature Fan mode Swing mode Swing horizontal mode HVAC mode Preset mode Temperature Temperature cool Temperature heat Unit |
| System Boiler | Current temperature HVAC mode Temperature Temperature cool Temperature heat Unit |
Event
A notification message pushed from the server is represented as an event platform. The Notification codes shows the full support range, and you can check the range of your device through the developer tools.
| Device | Property | Notification codes |
|---|---|---|
| Air Conditioner | Notification | water_is_full |
| Air Purifier | Notification | lack_of_water, time_to_clean_filter, pollution_is_high, time_to_change_filter |
| Air Purifier Fan | Notification | time_to_change_filter |
| Dehumidifier | Notification | water_is_full |
| Dish Washer | Error Notification |
cleaning_is_complete, error_during_cleaning, water_leak_has_occurred, rinse_is_not_enough, salt_refill_is_needed |
| Humidifier | Notification | time_to_change_filter, lack_of_water |
| Kimchi Refrigerator | Notification | door_is_open |
| Microwave Oven | Notification | none |
| Oven | Notification | preheating_is_complete, cooking_is_complete, time_to_clean, error_has_occurred |
| Refrigerator | Notification | time_to_change_filter, time_to_change_water_filter, frozen_is_complete, door_is_open |
| Robot Cleaner | Error Notification |
- |
| Stick Cleaner | Notification | charging_is_complete, time_to_clean_filter |
| Washer Dryer Washcombo Main Washcombo Mini Washtower Washtower Dryer Washtower Washer |
Error Notification |
washing_is_complete, error_during_washing, drying_is_complete, drying_failed |
| Styler | Error Notification |
styling_is_complete, error_has_occurred |
| Wine Cellar | Notification | door_is_open |
Fan
The properties for controlling the wind strength of the appliance are represented as a fan platform.
| Device | Property |
|---|---|
| Ceiling Fan | Power Speed |
Number
A read-write property which has a numeric value is represented as a number platform.
| Device | Property |
|---|---|
| Air Conditioner | Schedule turn-off Schedule turn-on Sleep timer |
| Air Purifier Fan | Sleep timer Wind temperature |
| Hood | Fan Light |
| Humidifier | Sleep timer Target humidity |
| Microwave Oven | Fan Light |
| Oven | Temperature |
| Refrigerator | Temperature |
| Dryer Styler Washer Washcombo Main Washcombo Mini Washtower Washtower Dryer Washtower Washer |
Delayed start/end |
| Water Heater | Temperature |
| Wine Cellar | Light Temperature |
Select
A writable property which has a list of selectable values is represented as a select platform.
| Device | Property |
|---|---|
| Air Conditioner | Air purify Air quality sensor |
| Air Purifier | Operating mode Speed |
| Air Purifier Fan | Display brightness Operating mode Rotation Speed |
| Dehumidifier | Speed |
| Dish Washer | Operation |
| Humidifier | Display brightness Drying mode Operating mode Speed |
| Oven | Cook mode Operation |
| Refrigerator | Fresh air filter |
| Dryer Styler Washer Washcombo Main Washcombo Mini Washtower Washtower Dryer Washtower Washer |
Operation |
| Water Heater | Operating mode |
| Wine Cellar | Light Operating mode |
Switch
A read-write property which has only two states that can be toggled is represented as a switch platform.
| Device | Property |
|---|---|
| Air Conditioner | Power Lighting Energy saving |
| Air Purifier | Power |
| Air Purifier Fan | Heating Power UVnano |
| Dehumidifier | Power |
| Humidifier | Auto mode Heating Mood light Power Sleep mode |
| Refrigerator | Express mode Express cool Quick freeze |
| System Boiler | Power Hot water |
| Wine Cellar | Ventilation |
Vacuum
The properties for controlling the clean operations of the appliance are represented as a vacuum platform.
| Device | Property |
|---|---|
| Robot Cleaner | Battery Current status Operation |
Water heater
The properties for controlling the operating mode and temperature are represented as a water_heater platform.
| Device | Property |
|---|---|
| Water heater | Mode Current temperature Temperature |
Sensor
A read-only property which has states is represented as a sensor platform.
| Device | Property |
|---|---|
| Air Conditioner | Filter remaining Humidity Odor Overall air quality PM1 PM10 PM2.5 Schedule turn-off Schedule turn-on Sleep timer |
| Air Purifier | Air quality sensor Humidity Odor Operating mode Overall air quality Personal mode PM1 PM10 PM2.5 Filter remaining Schedule turn-off Schedule turn-on |
| Air Purifier Fan | Air quality sensor Humidity Odor Overall air quality PM1 PM10 PM2.5 Sleep timer Temperature Schedule turn-off Schedule turn-on |
| Cooktop | Current status Power level |
| Dehumidifier | Humidity Operating mode |
| Dish Washer | Current cycle Current status Rinse aid dispenser level Softening level Delayed start Remaining time Total time |
| Home Brew | Brewing duration Brewing period Current status First flavor Second flavor Homebrew recipe First hop Second hop Recipe progress Wort Yeast |
| Humidifier | Air quality sensor Humidity Overall air quality PM1 PM10 PM2.5 Schedule turn-off Schedule turn-on Sleep timer Temperature |
| Kimchi Refrigerator | Fresh air filter Temperature |
| Microwave Oven | Current status |
| Oven | Current status Temperature |
| Plant Cultivator | Current status Day growth temperature Lighting duration Lighting intensity Lights on time Mode Night growth temperature Temperature Wind speed |
| Refrigerator | Fresh air filter Water filter used |
| Robot Cleaner | Current status Operating mode Running time |
| Stick Cleaner | Battery Current status Operating mode |
| System Boiler | Indoor temperature Inlet temperature Outlet temperature |
| Water Purifier | High-temp sterilization Type UVnano |
| Dryer Styler Washer Washcombo Main Washcombo Mini Washtower Washtower Dryer Washtower Washer |
Current status Delayed start/end Remaining time Total time Cycles |
Automation example
Notification, error event
- Guide: Automating on event
- Important: guide’s step 3, 4
- You can select the state change you want to act as trigger in step 4
alias: lack of water example
description: Toggle switch when air purifier's lack_of_water
triggers:
- trigger: state
entity_id:
- event.purifier_notification
actions:
- condition: state
entity_id: event.purifier_notification
attribute: event_type
state: lack_of_water
- type: toggle
device_id: xxxxxxxx
entity_id: xxxxxxxx
domain: switch
Troubleshooting
Setup
Aborted: The token is not valid
This error occurs when the Personal Access Token (PAT) is invalid or entered incorrectly. Please visit the Personal Access Token Page
Aborted: The country is not supported
Check your PAT’s valid country in the Choose the region / Country section.
Error: The number of API calls has been exceeded
This error occurs when there’s an abnormal number of API calls made using the PAT. The LG ThinQ integration will work properly after some time.
Debugging / Issue report
The LG ThinQ integration will show additional information by enabling log configuration.
-
Enable debug logging.
- If you change Enable to Disable, the log will be saved to the download folder.
- When reporting an issue:
- Provide screenshots of your device configuration (including device name, type, and entities).
- Include the debug logs.
- Describe the expected behavior and what’s not working.