OK everyone – I figured this out finally after some digging and risk taking. I have figured out a relatively simple way to reset a Hue bulb to factory fresh just using a Web Browser. I am going to describe this step by step so if you are an advanced user, this guide will likely not be very useful to you… but for those that are new or “regular users”, this may solve quite a lot of frustration. This technique works as of this writing on Easter Sunday 2017 so if you are reading this in the future, YMMV.
Problem this solves: If you acquire a hue bulb and you need it to behave as if it were factory fresh but for some reason, your Hue App can’t find the device. This can happen if the bulb has either been previously paired with another hub, or it came as part of a “bundle” paired to another device or worst yet, if you inadvertently tried to pair it with Smartthings hub first.
Step 1 - Go to the Philips Get Started page on their Developer page. On that page, it will guide you through exactly what needs to happen to access your Hue Bridge and more importantly, get your Hue Bridge ID
. This ID is not the ID you use on the App - it’s a special Hub Bridge ID needed to access the Hub. You will need to know the IP address of your Hue Hub. In my case, I just went to my router “attached devices” and found it there. My strong suggestion is to go through ALL of the examples on the Getting Started web page. It’s an interesting approach because in some cases, it will return an error – which is by design. Trust the process and do every example on that page.
Step 2 – Now you should have your Hub Bridge ID. It will look like this: iZWHR6lFLFK8GtqGxx7dM2j5gUOURlGJjZP6bfQlm
(I changed some characters in mine to use as an example here). Open up a text editor, word document or whatever and make a copy of this Bridge ID, just in case you need to find it later on. You should still be logged into the CLIP API Debugger which you accessed in Step 1.
In my case, I had 4 Hue White Bulbs that my Hue App couldn’t find. I found a spare lamp and placed it directly next to the hue bridge and used it for each bulb reset. The reason I did it this way is because after you issue the command below, it finds the closest lamp on the bridge and issues this reset command. I just wanted to be 100% certain.
Step 3 – Issue the touchlink command to reset the bulb
You should still be logged into CLIP. Where is says URL:, enter the following URL
http://192.168.1.19/api/YOUR-BRIDGE-ID/config
where YOUR-BRIDGE-ID, is the long Hue Bridge ID you created in Step 2. The IP address in my case is 192.168.1.19 but likely, your last number will be something different so use the IP address of the Hue Bridge you found in Step 1.
Then enter this in the Message Body
{"touchlink":true}
Click the Put
button - You are telling the hub to issue the touchlink command to reset the nearest bulb.
Step 4 – pair the newly discovered bulb using the Hue App. Then you are all set.
Lessons learned: Like a lot of people, I spent hours trying to find a solution to what I thought should be a simple thing to do. There are many methods out there and none of them worked for me except this one. Lampstealer didn’t work, the telnet into port 30000 process didn’t work. Someone had an app called iConnect Hue that used to work but it doesn’t now. So I learned that what works today, may not work tomorrow. I feel fairly certain this will work for a long time because we’re dealing with an API (Application Programming Interface), which tend to grow but usually don’t change parameters such as touchlink
.
I hope this helps. I will be happy if someone finds this useful and saves them some time and frustration, a maybe a few relationships too.