How to Add SmartThings Button to Home Assistant

If you're in the process of migrating from SmartThings to Home Assistant, then you probably have a lot of "SmartThings" branded buttons and sensors. If you're wondering how to add a SmartThings button to Home Assistant (without using the SmartThings integration!), then this guide is perfect for you.

This post is part of my “How to Migrate from SmartThings to Home Assistant” series. Other guides I have created are:

Step 1: Reset Your SmartThings Button

To reset your SmartThings button, simply flip the button over and insert a paperclip into the small hole for about 5 seconds.

Once you see the button flicker red and then green, your device has been reset and is now ready to be paired to Home Assistant.

You should also go ahead and delete it from the SmartThings app or from https://graph.api.smartthings.com.

Step 2: Pair SmartThings Button to Home Assistant.

For this step, you should already have the Zigbee Home Automation (ZHA integration setup). If you don't, check out my How To Add Z-wave and Zigbee devices to Home Assistant guide.

Go to Configuration > Integrations > ZHA > Configure.

Then, click Add Device. You should see "Device Found". Wait a few moments for the interview to complete.

Step 3: Rename Button & Assign to an Area

The next step is self-explanatory, but you'll want to rename your button and assign it to a room. This will make it easier to locate and assign automations to later on.

Once you see an Initialization Complete screen like the below screenshot, you are ready to start creating automations!

Step 4: Find Device ieee using HA Events

Next, click Developer Tools > Events tab > and enter zha_event to the Listen to events section.

Click Start Listening.

Then, simply click your button. You'll see it display a device_ieee: xx:xx:xx:xx:xx displayed in the code.

Copy that code to clipboard; you'll need it a few times for your automations.

Step 5: Creating Automations with SmartThings Button

SmartThings buttons allow for 3 button clicks: single press, double press, and hold. I'm sure there's a better way to go about this or consolidate into one automation, but I've created 3 separate automations for each button press.

Here's the example automation for toggling a lamp on or off using a SmartThings button which was added to Home Assistant. Change button_single with button_double or button_hold for automation #2 and automation #3.

SmartThings Single Button Press Automation:

device_ieee: "insert ieee' command: button_single

SmartThings Double Press Button Automation:

device_ieee: "insert ieee' command: button_double

SmartThings Long Press Button Automation:

device_ieee: "insert ieee' command: button_hold

Wrapping Up

That's it! That's all there is to adding SmartThings buttons to Home Assistant without needing to use the official SmartThings integration with hassio.

If you know of a better way to consolidate all 3 button presses into a single automation, let me know in the comments below!