Actions3
- Device Actions
Overview
This node integrates with Hubitat, a smart home automation platform, allowing users to interact with their Hubitat devices programmatically. Specifically for the Device - Send Command operation, it enables sending commands to a selected device with optional arguments. This is useful in scenarios such as turning on/off lights, adjusting thermostat settings, or triggering any custom command supported by the device.
Practical examples:
- Sending a "turnOn" command to a smart light bulb.
- Adjusting a thermostat temperature by sending a "setTemperature" command with the desired value as an argument.
- Triggering a custom action on a device that supports specific commands.
Properties
| Name | Meaning |
|---|---|
| Device | Select the target device to which the command will be sent. Options are dynamically loaded from your Hubitat devices. |
| Command | Choose the command to send to the selected device. Available commands depend on the device and are dynamically loaded. |
| Arguments | Optional string of command arguments separated by commas. These are passed as parameters to the command. |
Output
The output is a JSON object representing the response from the Hubitat API after sending the command. It typically contains the result or status of the command execution on the device.
If the command returns data, it will be included in the json output field. The node does not output binary data.
Example output structure (simplified):
{
"result": "success",
"data": { /* command-specific response data */ }
}
Dependencies
- Requires an active Hubitat API credential containing:
- Hubitat host URL
- Application ID
- Access token for authentication
- Uses the Hubitat REST API endpoints to perform operations.
- Requires network access to the Hubitat hub.
Troubleshooting
Common issues:
- Invalid or expired access token: Ensure the API credentials are valid and refreshed if necessary.
- Device or command not found: Verify the selected device and command exist and are accessible via the Hubitat API.
- Incorrect command arguments: Make sure arguments are correctly formatted and match the expected parameters for the command.
Error messages:
"Unable to load devices": Indicates failure to retrieve device list; check API credentials and network connectivity."Unable to load commands": Failure to fetch commands for the selected device; ensure the device supports commands and credentials are correct."Unable to load attributes": When fetching device attributes fails; verify device selection and API access.- Errors during command execution will be returned in the output JSON under an
errorkey if "Continue On Fail" is enabled.