SmartThings: Troubleshooting the Integration

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

FREE users: I'm a free user and my data has stopped flowing, but everything else looks fine, what's going on?
You should check to make suer you haven't consumed the 25,000 events included in the free tier of your Initial State account. Your event gauge resets every calendar month, however, the SmartThings integration may not reset automatically due to SmartThings marking the failed requests from the integration due to a "Payment Required" api response. To avoid running into this issue, simply make sure your account is upgraded!

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:
First Uninstall
1) Log into your Initial State account.
2) Go to your account page where the SmartThings integration tile is.
3) Click on the wrench in the top right of the SmartThings tile and then click "Deny" instead of Authorize. You may have to log into SmartThings first.
4) Verify that the SmartApp has been removed by opening your SmartThings mobile app, navigating to SmartApps and verifying that there is no SmartApp listed called "Initial State Event Streamer"

Second Install
1) Log into your Initial State account
2) Go to your account page where the SmartThings integration tile is.
3) Click the tile, select the location (if you have multiple), and select the devices under the capabilities you'd like to monitor. You may have to log into SmartThings first.
4) After some events have occurred for the selected devices/capabilities on your SmartThings network, you will start to see them showing up in your Initial State SmartThings Bucket.

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
  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 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.

Feedback and Knowledge Base