Setup Guide

Get Your Aqara API Keys

A step-by-step guide to register on the Aqara Developer Portal and obtain the credentials needed to use Smart Home Board.

Open Aqara Developer Portal
0

What You'll Need

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

Already have an Aqara account? Just sign in at developer.aqara.com — skip straight to Step 2.
2

Create an Application

ℹ️
The approval process is typically automatic and takes only a few seconds. If your app stays in "Pending" status, try refreshing the page.
3

Copy Your Credentials

⚠️
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

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.