---
created: 2026-05-26
modified: 2026-05-26
type: note
tags: []
aliases: []
---
# Tuya Local Integration Notes

## Tuya IoT Portal

- URL: https://iot.tuya.com/
- Navigate to: **Cloud → API Explorer**
- Select the correct **Data Center** (Central Europe for EU users)
- Use **Device Management → Query Device Details** to get device info

## Fields Required for Home Assistant (Tuya Local)

| Field | Source |
|-------|--------|
| **Device ID** | Tuya portal → Devices list or API Explorer |
| **Local Key** | API Explorer → Query Device Details |
| **IP Address** | Router's connected device list |
| **Protocol Version** | Usually auto-detected; try 3.5, 3.4, or 3.1 |

## Steps to Add a Device

1. In HA: Settings → Devices & Services → Tuya Local → Add Device
2. Choose **Manually provide device connection information**
3. Enter IP, Device ID, Local Key, Protocol
4. Select device type (e.g., Simple RGBCW lightbulb for RGB+CCT bulbs)
5. 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