SubscribeDevice

POST

Subscribe Device

This API will subscribe a device to real-time events, if you are allowed access.

NOTE: this API requires Client Credentials authentication.

Valid subsystem types:

  • "TCC" - Round Smart Thermostats
  • "lcc" - T-Series Thermostats working on the Resideo Smart Home app
  • "wld" - Water Leak Detector
  • "camera" - Awareness Cameras
  • "ds" - First Alert App Devices

Example curl for Water Leak Detector:

curl -X POST \
'https://api.honeywellhome.com/v3/events/subscribe/subsystem/wld/mac/a15b7da4-3d19-4869-a48e-3cb4cf7f9fc7?apikey=apikeyhere' \
-H 'authorization: Bearer q1PvOeq0mqb6QwJDo1SBpCMF9kC6' \
-H 'cache-control: no-cache'

Example curl for a First Alert Device:

curl -X POST \
'https://api.honeywellhome.com/v3/events/subscribe/subsystem/ds/mac/B82CA0032222?apikey=apikeyhere' \
-H 'authorization: Bearer rxpeJExfTpg4ytEU4CKO7ZZ7wfG8' \
-H 'cache-control: no-cache'

Resource URL

https://api.honeywellhome.com /v3/events/subscribe/subsystem/{subsystem}/mac/{deviceId}

Query Parameters


Name Values Description
apikey

API Key


Header Parameters


Name Values Description
Authorization
(required)

OAuth2 Client Credentials Token

Request Body

subsystem Device Subsystem (e.g., 'Tcc', 'lcc', 'das')

deviceId Device ID, typically found in the GET locations API

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Response Error Details

  • HTTP Code
    Error Code
    Description
  • 401 - Unauthorized

    Either token is expired, or not authorized to subscribe the device

Resource Summary

Security

Category

Events

Working...