Cloud API Setup
The Tuya integration integrates all Powered by Tuya devices you have added to the Tuya Smart and Tuya Smart Life apps.
Note
LocalTuya uses the cloud to obtain your device's data, making the configuration of devices much simpler.
Configuration of the Tuya IoT Platform
Prerequisites
- Your devices need first to be added in the Tuya Smart or Smart Life app.
- You will also need to create an account in the Tuya IoT Platform. This is a separate account from the one you made for the app. You cannot log in with your app's credentials.
Create a project
- Log in to the Tuya IoT Platform.
- In the left navigation bar, click
Cloud
>Development
. - On the page that appears, click
Create Cloud Project
. -
In the
Create Cloud Project
dialog box, configureProject Name
,Description
,Industry
, andData Center
. For theDevelopment Method
field, selectSmart Home
from the dropdown list. For theData Center
field, select the zone you are located in. Refer to the country/data center mapping list here to choose the right data center for the country you are in. -
Click
Create
to continue with the project configuration. - In Configuration Wizard, make sure you add
Industry Basic Service
,Smart Home Basic Service
andDevice Status Notification
APIs. The list of API should look like this: - Click
Authorize
.
Link devices by app account
- Navigate to the
Devices
tab. - Click
Link Tuya App Account
>Add App Account
. -
Scan the QR code that appears using the
Tuya Smart
app orSmart Life
app using the 'Me' section of the app. -
Click
Confirm
in the app. - To confirm that everything worked, navigate to the
All Devices
tab. Here you should be able to find the devices from the app. - If zero devices are imported, try changing the DataCenter and check the account used is the "Home Owner". You can change DataCenter by clicking the Cloud icon on the left menu, then clicking the Edit link in the Operation column for your newly created project. You can change DataCenter in the popup window.
Get authorization data
Click the created project to enter the Project Overview
page and get the Authorization Key
. You will need these for setting up the integration. in the next step.
Data center region
:
Choose the country you picked when signing up.
Client ID
:
Go to your cloud project on Tuya IoT Platform. in the Overview tab.
Client Secret
:
Go to your cloud project on Tuya IoT Platform. in the Overview tab.
Get USER ID
Navigate to the Devices
tab -> click on Link Tuya App Account
Copy UID <- is User ID
.
Error codes and troubleshooting
1004: sign invalid
Incorrect Access ID or Access Secret. Please refer to the Configuration part above.
1106: permission deny
-
App account not linked with cloud project: On the Tuya IoT Platform, you have linked devices by using Tuya Smart or Smart Life app in your cloud project. For more information, see Link devices by app account.
-
Incorrect username or password: Enter the correct account and password of the Tuya Smart or Smart Life app in the Account and Password fields (social login, which the Tuya Smart app allows, may not work, and thus should be avoided for use with the Home Assistant integration). Note that the app account depends on which app (Tuya Smart or Smart Life) you used to link devices on the Tuya IoT Platform.
-
Incorrect country. You must select the region of your account of the Tuya Smart app or Smart Life app.
1100: param is empty
Empty parameter of username or app. Please fill the parameters refer to the Configuration part above.
2406: skill id invalid
-
Make sure you use the Tuya Smart or SmartLife app account to log in. Also, choose the right data center endpoint related to your country region. For more details, please check Country Regions and Data Center.
-
Your cloud project on the Tuya IoT Development Platform should be created after May 25, 2021. Otherwise, you need to create a new project.
-
This error can often be resolved by unlinking the app from the project (
Devices
tab >Link Tuya App Account
>Unlink
) and relinking it again.
28841105: No permissions. This project is not authorized to call this API
Some APIs are not authorized, please Subscribe then Authorize. The following APIs must be subscribed for this tutorial:
- Device Status Notification
- Industry Basic Service
- Smart Home Basic Service
- Authorization
- IoT Core
- Smart Home Scene Linkage
- IoT Data Analytics
28841002: No permissions. Your subscription to cloud development plan has expired
Your subscription to Tuya cloud development IoT Core Service resources has expired, please extend it in Cloud
> Cloud Services
> IoT Core
> My Subscriptions
tab > Subscribed Resources
> IoT Core
> Extend Trial Period
.