The following example SmartApp is the equivalent of a simple Rule (if contact sensor opens/closes, turn lights on/off) which is easily achieved via our Rules API. This simple automation is used here as a brief functional showcase of a SmartApp using the Node SDK, and is not meant to be a good candidate for a SmartApp. Be sure to check if your automation is possible with the Rules API, as it will benefit from speed, stability, and security through future local execution support.
To get going quickly with this example, we've provided a few options for hosting below. Follow any one of them to get the app up and accepting requests before moving on to registration instructions.
View logs in the Heroku dashboard.
Click the Open app button in the Heroku dashboard app page to copy the public URL for use in steps below.
View logs in the Glitch editor.
Copy the Live Site URL from Glitch for use in steps below.
To make this work locally, we recommend using ngrok to create a globally available URL for fast testing.
npm install
npm start
ngrok http 3001
Follow the instructions for registering a SmartApp with the SmartThings platform.
- The following OAuth2 scopes are required.
r:devices:*x:devices:*
A CONFIRMATION request log should show in the log output of the server once registered. Navigate to this link to verify your domain ownership and enable the app to receive events. This is required for successful installation.
Follow the instructions for testing a SmartApp.
- smartapp.js — the SmartApp implementation
- server.js — the Express server that hosts the SmartApp as a web-hook
- locales/en.json — English version of the app configuration page text