Home Assistant Integration on Stream Deck

I recently found a YouTube video about controlling Home Assistant by using Stream Deck: (243) Controlling Home Assistant from the Elgato Stream Deck – YouTube. A big thanks to Andy Smith sharing this with the community!

So I had to try this by myself. Here the steps which I had taken to configure the integration:

1st Step: Create Token in Home Assistant

Here’s how to get to the token page
A small windows appears – Enter the name for your token
Copy the token to your clipboard and save it in a secure location

2nd Step: Download and install API-Ninja for Stream Deck

3rd Step: Configure your button for Stream Deck

Note that I will not explain how to configure icons and their behaviors here.

There are now several options which need to be configured on the API Ninja button. Here’s an overview about the configuration to be done:

FieldDescriptionParameters/SelectionsExample: Toggle a sceneExample: Read Temp from sensor
TitleDefines the text of the button.“your title”<must be empty! Otherwise information will not be displayed>
Request TypeDefines the type of request. Sending commands to home assistant requires the POST type. Receiving information form home assistant requires the GET typePOST or GETPOSTGET
API URLThe URL to your home assistant server. Ensure to mention the correct hostname or IP address followed by the according port. The paths should be pointing to the according action required from the API. The actions you will mostly need are: “toggle” , “turn_on”, “turn_off”http://your-homeassistant-server:8123/api/services/homeassistant/toggle


http://your-homeassistant-server:8123/api/services/homeassistant/toggle http:// your-homeassistant-server:8123/api/states/sensor.multisensor_office
Content TypeDefines the type of content to be sent/received. For home assistant it has to be set to “application/json”always select “application/json” “application/json” “application/json”
Load data/headers from filesDisable this option
HeadersIs used to define the API request headers. Here you need to enter your token which you created earlier. Make sure to put the following text in front of the token: Authorization:BearerAuthorization:Bearer eyJ0eXAiOiJKV1QiLC……..

(not full key mentioned here)
Authorization:Bearer eyJ0eXAiOiJKV1QiLC…….. Authorization:Bearer eyJ0eXAiOiJKV1QiLC……..
DataThis field defines the data which will be sent/received via API. Make sure to follow the JSON syntax here. The entity ID can be found in the home assistant configuration under “Entities”{
“entity_id”: “scene.office_lights_on”
“entity_id”: “scene.office_lights_on”
“entity_id”: ” sensor.multisensor_office “
Response shownResponse from API that will be shown on key. Use * to show everything, or use a JSON path such as name.firstname

Not used for POST request type
<leave empty>state

(this is the path to the information)
Response TypeDefines how you want to handle responses from API. Response is text Response is text
Autorun every:Defines if an API request should be autorun. Useful in case of GET requests. <leave empty>120 seconds

(or whatever interval you prefer)
Save ‘Response’ shown’ to fileHelpful if you’re dealing with GET requests. Let’s you debug the information to a file. This way you can investigate on the received information. <leave empty>