July 15, 2016
For those of us interested in home automation, this might be a familiar scenario: You’ve bought that new 4-in-1 sensor you’ve wanted for a while, and rush to unwrap the package like a kid on Christmas Day. Then you insert the batteries and make your way to your SmartThings hub to include it into your network. And then the disappoint descends: it’s a sensor that’s new on the market, and it’s more complicated to integrate it than a simple on/off device. It will probably take a while before SmartThings provides official support for it. So how do you include a Z-Wave device to your hub if it's not on the list?
This is where custom device handlers come in: community members will often develop their own code to be able to use new devices with SmartThings. They usually publish them on development platforms like GitHub and then post a link to the code on the SmartThings forum. But they don’t always include instructions on how to install the custom device handler and assign it to the device. The average user may think it’s a complicated process, when in fact it’s quite simple!
Here are some instructions that should help you get a custom device handler (i.e. that awesome new device of yours!) to work in SmartThings. I’ll be taking the Zooz 4-in-1 Sensor as an example, but this process will work for any device that needs a custom handler (you’ll just need to use a different link for the right code).
1. Log in here with the same username and password you use for your SmartThings app: https://consigliere-regional.api.smartthings.com
2. Click on My Device Handlers in the top menu
3. In the top right corner, click on Create new device handler and choose From code from the top tab menu. You'll be presented with a blank area where you can copy the code from this link and paste it in (it's always best to use the raw version of the code)
4. Next, scroll to the bottom and click Create. Now click Save, then click Publish > for me.
You should now see this device type in your list of Device Handlers
Simply exclude the device if you had included it prior to installing the new device handler. Then add the device to your SmartThings hub by clicking on Add thing > + Connect New Device in your app. Press and release the Z-Wave button on the sensor twice quickly.
Remember to keep the device within 3 feet away from your hub during inclusion — the device should be automatically discovered as the Zooz 4-in-1 sensor. Then, leave the sensor by the hub for a few hours so it can fully configure.
And that should be it! I hope this was helpful in simplifying the process behind custom device handlers. Feel free to share your questions and feedback in the comment section below!
July 14, 2020
You actually don’t need to use the SmartThings Classic app to take advantage of the custom device handlers. The instructions refer to the IDE portal and some handlers are not optimized for the new app but for the most part, the handler installation process is not related to the app you’re using at all.
July 07, 2020
TO USE DEVICE HANDLER – INSTALL “SAMSUNG SMARTTHINGS CLASSIC” APP!!!
WON’T WORK WIH NEW ONE.
I’ve spent like an hour to figure out why I can’t find any place to add custom device…
Please update post with this info.
August 17, 2018
Hi Brian, this looks like an issue with the device handler. We don’t carry this particular product so don’t have any experience with getting it integrated with any Z-Wave system unfortunately. We recommend reaching out to the developer who wrote the code, it may be outdated and needs an update to conform to the latest platform standards on SmartThings.
August 14, 2018
I have read 5 different tutorials that all give the same instructions but when I hit “Create” I get this error: Org.springframework.security.access.AccessDeniedException: Run Locally Permission not allowed for DeviceType: d903c6b9-cf7c-4173-b72e-1fb06ba4b8ee
Why and how do I fix this? I’m trying to get my Remotec relay to work again since there no longer seems to be a Generic Z-wave Device option in Smartthings
December 22, 2017
It’s possible you need to reset the sensor first. Please try this:
1. Tap the menu icon in your SmartThings app
2. Tap Hub is online
3. Tap Z-Wave Utilities
4. Tap General Device Exclusion
5. The app will show this message: “Please follow the manufacturer’s instructions to remove the Z-Wave device from My SmartThings.” There will also be a spinning circle next to the message “Exclusion Mode Active”
6. While Exclusion Mode is active, click the Z-Wave button on the sensor with a paperclip 3 times very quickly
7. The app will confirm device exclusion
8. Tap Done
Once exclusion is completed, please try adding the device again by clicking on Add Thing in the ST app and clicking the Z-Wave button 3 times with a paperclip quickly.
Let us know if that helped!
December 19, 2017
I can not get my sensor to connect. I’ve installed the device handler, I go to “add a thing”, and I press the button on the bottom of the sensor with a paper clip twice quickly and it blinks 5 times. Smartthings never finds it and I’m within 3 feet from my hub. Any suggestions?
September 26, 2017
We’re glad that was helpful Lionel!
September 25, 2017
ok, got it, the inside switch is the wrong button, need to use the paper clip then it worked great.
thanks for the post!
September 24, 2017
thanks for the instructions, I added the device handler on both
I have 2 ZooZ but they don’t get detected when I do Add Thing.
There is a tiny switch inside the device, I tried to press once, twice, thrice, quick/slow, hold…, the Zooz blinks green once and that’s all.
I don’t know what to do now.
Thanks for tips!
September 05, 2017
There may be a few reasons why the device isn’t recognized correctly. Either the handler was not published in the right place or the device had been included before you published the handler or there’s another configuration issue at play. Please get in touch with our support so they can go through different troubleshooting options with you and help you solve the problem. Thanks!
same here as Dan. It discovers the device as generic and not as a zooz one..am i missing something in settings?
August 15, 2017
Hi Mike, did you try waking the sensor up manually by clicking on the Z-Wave button 3 times quickly after you made the change in the settings? If not, the change hasn’t been registered by the sensor yet.
I installed a second z-wave 4 in 1 and this handler was already installed and everything seems to work properly except the LED option. I have it set to 1 (for no LED) but it is still flashing red every few minutes. My other 4 in 1 (identical) does not flash. Any thoughts?
March 14, 2017
Hi Dan, we’re glad to hear you were able to make it work. Between the 2 different URL’s, it can be kind of confusing. We always recommend to start with checking if your sensors and switches are listed under My Devices first – if they’re not there, it means you need to log in using the alternative URL to install the handler in: https://graph-na02-useast1.api.smartthings.com
March 12, 2017
Nevermind, I find out now that ST’s shards aren’t all properly tied together… I had to be sure I was in the right shard.
March 11, 2017
So I follow these instructions exactly but when it finds the device it STILL just thinks it’s a generic z-wave sensor device. The Zooz name does not appear in the “found devices” list. I have tried this with three (3) versions of ZSE40 device handler code I found out there. I see them all in my device handlers list but they don’t seem to make any difference. Thoughts??
Comments will be approved before showing up.
August 06, 2020
If you already have Amazon Echo set up, you know how convenient it can be. There’s nothing like walking out the front door with full hands and telling Alexa to turn off your lights last minute. But these smart lights and plugs can be slow to react as you keep adding more smart home devices and clogging your network.
Alexa only “speaks” WiFi (and ZigBee if you have the EchoPlus). It currently doesn’t support Z-Wave, the protocol of choice for home automation thanks to its high speed and low interference with other connected devices in your home. That means you can’t have a Z-Wave switch or plug speak directly to your Echo. BUT you can use a smart home hub as a bridge between your Z-Wave devices and Amazon Alexa. Now that’s a whole other level of functionality to unlock!
And if you already have a Z-Wave hub but no smart speaker, you might be thinking how cool it would be to have voice control for your automations and smart home devices. It’s a step towards a more integrated, easy-to-use smart home with improved security, comfort, and convenience.
May 10, 2020
Starting May 13, 2020, Wink will be charging its users a $4.99 monthly subscription fee. If you don’t pay, you’ll lose your automations, smart rules, and access to voice control. [Update 5/30/20: Wink has since backed out of the decision, at least for now. Update 7/27/20: The subscription service for Wink is finally in effect.]So is it worth paying $5 a month for Wink’s service? The platform hasn’t been adding new features or expanding its list of supported devices for a while now. The announcement introducing the subscription model didn’t include any details on when and how the system would start updating again. They also failed to give users at least 30 days notice to consider how to move forward. If you’re thinking about switching to another platform, we can’t blame you. Here are a few alternatives for reliable smart home solutions that are most popular among our customers and the team here at The Smartest House. They’re all one-time investments without monthly fees. You’ll find a list of benefits and limitations with each platform, but if you have any questions about specific features we didn’t cover here, get in touch or post in the comment section below.
November 05, 2018
Winterizing your home used to mean lots of physical labor - caulking windows, installing heavier drapes, maybe even changing out older windows and doors that were too efficient at releasing insulated air. Winter prep can still mean all of the above, but new Z-Wave technology has made certain aspects of winterization easier while adding another level of protection as those temperatures drop.
Here’s what we’re using to stay cozy and make sure our energy bills don’t make us freeze in our tracks:
This is one of our winter must-haves. It’s the first Z-Wave line voltage thermostat in North America (but be careful, it won’t work with forced air systems!). Use it to control electric baseboards and convector heaters all from your Z-Wave hub’s app interface. Reduce your energy consumption by 30% with custom heating schedules, or just switch to the thermostat’s built-in Economy mode to keep things efficient.