Purpose

July 3, 2025 ยท View on GitHub

The purpose of this documentation is to be able to configure the Tuya IOT Platform cloud credentials in Xtend Tuya.

READ THIS CAREFULLY

Some initial configurations have to be done right the first time, this is because they are a pain to update afterward if you got them wrong.
To be prepared, please determine your correct data center:

  • If in Europe: Central Europe Data Center
  • If in US: Western America Data Center
  • If in China: China Data Center
  • If in India: India Data Center

DO NOT USE THE WESTERN EUROPE OR EASTERN AMERICA DATA CENTERS, THEY ARE RESERVED FOR BUSINESS CONSUMERS

Steps

1- Create your Tuya IOT Platform account
1.1- Go to https://iot.tuya.com/
1.2- Create your account
1.3- Login to your newly created account

2- Create a development project
2.1- On the left, hover over Cloud then select Project Management:
image
2.2- Click "Create Cloud Project"
2.3- Give any relevant name and description to your project
2.4- Set "Smart home" in both "Industry" and "Development Method"
2.5- Set the correct data center (Refer to the notes at the beginning of the development to do so, this is very important!)
image
2.6- Click "Create"
2.7- In the next screen, click "Authorize"
image

3- Link you Tuya/SmartLife app to your cloud account
3.1- On the left, hover over Cloud then select Project Management:
image
3.2- Open your cloud project created in step 2 by clicking the "Open Project" link
image
3.3- Go to the "Devices" tab
image
3.4- Click the "Link App Account"
image
3.5- Click the "Add App Account"
image
3.6- Open your Tuya/SmartLife app, go to the "Profile" and use the Scan Barcode button on the top right
3.7- Scan the QR code generated in step 3.5 with your smartphone and approve the connection
3.8- In the next screen, select "Automatic Link" and click OK
image
3.9- In the end, you should have something that looks like this:
image

4- Gather the information needed by XT Tuya
4.1- In the screen of 3.9, copy the value under the column "App Account" in a notepad
image
4.2- Go to the Overview tab and copy the values of Client ID and Client Secret in a notepad
image

5- Enter your credentials in eXtend Tuya
5.1- Go to the Settings page in HA
image
5.2- Go to "Device & services"
image
5.3- Click on "Xtend Tuya"
image
5.4- Click on the "Configure" button next to the account you want to configure
image
5.5- In the popup, enter the following information

  • Country is the country you are in
  • Tuya IoT Access ID is the Client ID you retrieved in step 4.2
  • Tuya IoT Access Secret is the Client Secret you retrieved in step 4.2
  • SmartLife/Tuya account is the App Account you retrieved in step 4.1
  • SmartLife/Tuya account password is the password you use when logging in the SmartLife/Tuya app on your smartphone
    image
    5.6- Click Submit, if everything went correctly you should have a success message
    image
    5.7- Restart your Home Assistant and enjoy!