After following this guide, you'll have three values to paste into the app:
| Field in App |
Portal Name |
Description |
App ID |
AppId / Client ID |
Identifies your application on the Aqara platform |
Key ID |
KeyId |
Identifies the key pair used for request signing |
App Key |
AppKey / Client Secret |
Secret used to sign requests — keep this private |
1
Create a Developer Account
-
-
Click "Sign Up"
Use your email address to register a new account.
-
Verify your email
Check your inbox for a verification email from Aqara and click the confirmation link.
-
Select your region
Choose the same region where your Aqara devices are registered. This is important — using the wrong region will cause authentication to fail.
-
-
Click "Create App"
Fill in a name (e.g. Smart Home Board) and a short description. The exact values don't matter for functionality.
-
Select "Open Platform" as the app type
This grants access to the Open API used by this app.
-
Submit and wait for approval
App creation is usually instant. Once approved, your credentials will appear in the app details page.
ℹ️
The approval process is typically automatic and takes only a few seconds. If your app stays in "Pending" status, try refreshing the page.
-
Open your app's detail page
Click on the app you just created from the "My Apps" list.
-
Find the "App Credentials" section
This section shows your AppId, KeyId, and AppKey.
-
Copy all three values
Use the copy buttons next to each field. You'll paste them into the Smart Home Board app on the next step.
⚠️
Keep your App Key secret. Do not share it publicly or commit it to source code. It acts as a password for your Aqara application.
4
Enter Credentials in the App
-
Open Smart Home Board
If you haven't set up credentials yet, the Home tab will show the setup form automatically.
-
Paste your credentials
Fill in App ID, Key ID, and App Key from the portal.
-
Tap "Save"
Credentials are stored locally on your device only — they are never sent to any third-party server.
✅
You can update your credentials anytime from Settings → Aqara API Credentials.
★
Choose the Right Region
The app connects to the Aqara server for the region where your account was created. Using the wrong region will cause login or device lookup to fail.
🇨🇳
China
open-cn.aqara.com
🇺🇸
USA
open-usa.aqara.com
🇩🇪
Europe
open-ger.aqara.com
🇰🇷
Korea
open-kr.aqara.com
🇸🇬
Singapore
open-sg.aqara.com
🇷🇺
Russia
open-ru.aqara.com
ℹ️
If you are unsure which region to use, check the Aqara app on your phone under Profile → Settings → Server Region.