How to Set Up Tuya Integration (Stable) in Home Assistant

This topic describes how to install and use the official Tuya integration in Home Assistant.

Prerequisites

• You have created a cloud project of Smart Home type on the Tuya IoT Development Platform, added at least one real device or one virtual device, and authorized your project to use the required API services. For more information, see Configuration Wizard of Smart Home PaaS.

  If your cloud project was created before May 25, 2021, you need to perform project migration. For more information, see How to Migrate to the Tuya Home Assistant Integration.

• You have installed Python 3.8 (including python3-dev) or a later version on your system.

Set up

After you have installed Home Assistant Core, you can search for and set up the Tuya integration in Home Assistant.

1. Enter localhost:8123 into the address bar in your browser and hit Enter to connect to Home Assistant.

2. Register and log in.

3. Click Configuration > Integrations.

   

4. On the Integrations page in the configurations panel, click the + button in the lower right and search for Tuya.
   

5. Select Tuya and set up the integration.

   

6. Enter your Tuya credentials.

   

   Fields	Description
   Country	Select the region of your account of the Tuya Smart app or Smart Life app. Note: Open the mobile app you use and tap Me > Setting > Account and Security > Region.
   Tuya IoT Access ID and Tuya IoT Access Secret	Go to the Tuya IoT Development Platform and select your cloud project. Click the Overview tab and find the Access ID and Access Secret in the Authorization Key area.
   Account	Your account of the Tuya Smart app or Smart Life app.
   Password	Your password for the Tuya Smart app or Smart Life app.

   The mobile app mentioned in the above table must be the one you use to scan the QR code for linking devices to your cloud project on the Tuya IoT Development Platform.

7. Click Submit.

   Click Overview in the sidebar on the left. You will find all the smart devices linked to your cloud project created on the Tuya IoT Development Platform.

   

FAQs

I got an error saying ‘Config flow could not be loaded’ when setting up the Tuya integration. How to fix it?

Go to custom_components under the Home Assistant directory and delete the tuya_v2 folder. Restart Home Assistant and try installing the integration again.

I got an error shown in the following screenshot when I tried to scan a QR code to link my devices to my cloud project. How to fix it?

This is because the data center you selected for your cloud project cannot serve the region of your app account. You must switch to the correct data center and scan the QR code again.

1. Here is how to find the region: open the mobile app you use and tap Me > Setting > Account and Security > Region.

   

2. See Mappings Between OEM App Accounts and Data Centers and find the data center that can serve your region.

3. (Optional) If you do not find the data center you want to use, click the Overview tab and then Edit to add data centers.

   

4. Click the Devices tab > Link Tuya App Account. Select the correct data center from the drop-down menu in the top right corner and click Add App Account.

   

5. Scan the QR code again to link devices.

Will I be billed after the free trial of the API service expires?

• After your API service expires, go to Cloud > My Services on the Tuya IoT Development Platform to request extending your API service by up to 6 months.

  1. Click Extend Trial Period.

     

  2. Complete this form.

     

  3. You will get the result within one working day.

     

• The Trial Edition allows you to use all free API services but puts limits on the quota of API calls. For more information about the quota, see Pricing.

How to deal with the following errors?

Error code sample:

[tuya-openapi] Response: {
  "code": 2406,
  "msg": "skill id invalid",
  "success": false,
  "t": 1624477851701
}

How to get the diagnostic log?

You can get the diagnostic log with the following two options.

• Option 1: Edit the configuration file. You can get the complete log but you need to restart Home Assistant after editing the file.

  1. Copy the following code to the configuration.yaml and save.

     logger:
       default: critical
       logs:
         custom_components.tuya_v2: debug
     

  2. After your Home Assistant is restarted, you can check the log of Tuya integration from the Terminal or from the home-assistant.log file.

     

• Option 2: Export the log directly.

  1. On the homepage of the Home Assistant, choose Configurations > Devices & Services.

     

  2. Find the Tuya integration and click ⋮ > Download diagnostics to download the log file.
     

What categories are supported by the Tuya Home Assistant integration？

See the following table for supported device categories.