Troubleshooting the SmartThings Integration

For the rare scenario when the SmartThings integration isn't automagical, here are a few troubleshooting steps to consider:

I've connected SmartThings following the tutorial, but I don't see a bucket created, what do I do?

First, try waiting a few minutes or triggering a some events in your SmartThings home network like turning lights on and off. The SmartApp should create a bucket as soon as it's configured from your account and if it doesn't it will try again once it sends the first payload of events (after 10 events have occurred or 15 min has passed since the integration was enabled, whichever happens first).

I connected SmartThings and a bucket was created but there is no data, where is it?

SmartThings requests that apps with high traffic like ours buffer requests before sending them. So, the integration only sends events after 10 events have been collected or 15 mins has passed, whichever occurs first. This means you're guaranteed to get all the events that happened in 15 min intervals or sooner if you have more frequent events on your SmartThings network.

My SmartThings events were streaming to my bucket, but they've now stopped, how do I get it started again?

Sometimes, although extremely rarely, the SmartApp integration may stop sending events. If this happens, you can simply re-configure the SmartApp integration by uninstalling and re-installing the SmartApp integration with these instructions:

Additionally, if you want the data to go to the previously created SmartThings bucket, you can simply change the bucket that the SmartApp is configured to use by clicking on the name of the bucket inside the SmartThings configuration tile in your Initial State account. When you click on the name, it turns into an editable dropdown box. The dropdown box is a list of your bucket names and, to the right of the name, the "bucket key". Select the bucket you were previously using and you should be good to go!
If you have any issues with this, please contact us.

Sending Troubleshooting Data to Initial State

If you can't get your connection up and running, you can send us some information to help you debug your SmartThings SmartApp. To get this information, follow these steps:

1. Open a browser and go to ide.smartthings.com
2. Log in with your SmartThings credentials if prompted
3. Navigate to "My Locations"
4. If multiple locations are associated with your account, select the location you're debugging
5. Go to the bottom and select "List SmartApps"
6. Go to the bottom and select the "Initial State Event Streamer" SmartApp link
7. Go to the bottom and send [email protected] a screenshot of the information starting at Application State going to the bottom of the window.

Ok, I'm an advanced/curious user and the integration keeps stopping. What can I do?

We've published a DIY version of the SmartApp that removes the OAuth integration and allows the user to change whatever they'd like and publish the SmartApp for themselves. It does not do any buffering and sends events right as they happen. This version is not officially supported and is much more manual in the setup and installation process. It also doesn't show under the Initial State account settings like the official version. You can find more information about it in this support article.

I am getting the error "Client is not associated with a SmartApp in location". How do I get around this?

The DIY version of the SmartApp (discussed above) does not have this issue as it is associated to SmartThings OAuth implementation. Sometimes, there are inconsitencies with this implementation across geographic regions. Check out SmartThings Platform Status for more information. You can also find more information about it in this support article.