Tuya Local Integration Notes

Tuya IoT Portal

URL: https://iot.tuya.com/
Select the correct Data Center (Central Europe for EU users)
Access ID: pwwd8y3v7kj8j9c3nnj5

Renavigating After a Device is Re-Paired / Reset

When a Tuya device is reset and re-paired to WiFi, it gets a new Device ID and new Local Key. The old credentials are invalid. Steps to recover:

1. Check IoT Core Subscription

If API calls return code: 28841002 / "IoT Core service subscription has expired.":

Go to iot.tuya.com → Cloud → IoT Core (under Cloud section)
You'll likely see an option to extend the service trial period
There's a form asking for: project background, estimated lead time, relevant info
Sample blurb: "Personal home automation project using Home Assistant to control smart lighting. Need temporary API access to retrieve local device keys for re-paired bulbs."
Estimated lead time: 1–3 days
Approval is usually quick (sometimes instant, sometimes minutes)

2. Get the New Device ID (Virtual ID) from the Phone App

The new Device ID is not visible in the IoT portal's device management. You need to get it from the app:

Open the Tuya Smart / Smart Life / Genio app on your phone
Go to the device details/settings page for the device
Look for Device Information → Device ID (or Virtual ID) — this is the ID to use in the API
Copy this ID — it looks like: bfd8b357cc21529eb8zpbo

3. Query Device Details via API Explorer

Go to Cloud → API Explorer (not IoT Core → API Explorer)
Method: Query Device Details under Device Management
Enter the new Device ID from the app
Execute
In the response, note the "local_key" field

4. Add to Home Assistant (Tuya Local)

In HA: Settings → Devices & Services → Tuya Local → Add Device
Choose Manually provide device connection information
Enter:
- IP Address — from router's connected device list
- Device ID — from app
- Local Key — from API Explorer response
- Protocol — Try 3.3 or 3.4 first, or try 3.1 if those fail
Select device type (e.g., Simple RGBCW lightbulb for RGB+CCT bulbs)
Submit

Fields Required for Home Assistant (Tuya Local)

Field	Source
Device ID (Virtual ID)	Phone app → Device Info page
Local Key	IoT Portal → Cloud → API Explorer → Query Device Details
IP Address	Router's connected device list
Protocol Version	Usually auto-detected; try 3.3, 3.4, or 3.1

Steps to Add a Device

In HA: Settings → Devices & Services → Tuya Local → Add Device
Choose Manually provide device connection information
Enter IP, Device ID, Local Key, Protocol
Select device type (e.g., Simple RGBCW lightbulb for RGB+CCT bulbs)
Submit

Notes

Close Tuya/Smart Life app on phone before adding devices
Genio bulbs may need the Genio app for initial WiFi setup
Some newer bulbs use Protocol 3.5 (auto-detected by Tuya Local)
If port 6668 is closed on the device, it may be cloud-only
The Local Key rotates every time a device is re-paired — always get a fresh one via API Explorer

3.2 KiB Raw Blame History Unescape Escape