diff --git a/source/_integrations/simplisafe.markdown b/source/_integrations/simplisafe.markdown index c9018056afe..d7e8a1ae5d1 100644 --- a/source/_integrations/simplisafe.markdown +++ b/source/_integrations/simplisafe.markdown @@ -36,6 +36,28 @@ There is currently support for the following device types within Home Assistant: {% include integrations/config_flow.md %} +## Getting an Authorization Code + +
+Because of a technical limitation, the below instructions will not work for iOS users as-is. It is recommended that you set up the SimpliSafe integration from a desktop browser. If you must use an iOS device, please ensure that the SimpliSafe app is not installed before beginning; the app can be re-installed after the integration is set up. +
+ +Starting in 2021, SimpliSafe has moved to a new authentication mechanism via its web app. Below are instructions on retrieving the authorization code needed to finish setting the integration up. + +1. Initiate adding the integration via the instructions above. +2. When prompted, click the link that opens the SimpliSafe web app. +3. Input your SimpliSafe credentials. You will see "Verification Pending" – leave this browser tab open. +4. Check your email for a message from SimpliSafe. When you have received that email, click "Verify Device" – note that this will open a second browser tab/window. +5. After the verification is successful, return to the first browser tab/window. The browser will show an error about not being able to navigate to the page; ignore it. + +At this stage, take a look at the address bar and note the `code` parameter at the very end of the URL: + +```txt +com.simplisafe.mobile://auth.simplisafe.com/ios/com.simplisafe.mobile/callback?code= +``` + +Copy/paste this code parameter into Home Assistant to finish setting up the integration. + ## Services Note that the `system_id` parameter required by the below service calls can be discovered