Overview
This node integrates with Hyundai and Kia vehicles via the BlueLinky library, allowing users to remotely control and query their vehicles. It supports operations such as listing vehicles, fetching vehicle status, location, odometer readings, locking/unlocking doors, and starting or stopping the engine/climate system.
A common use case is automating vehicle management tasks within workflows, for example:
- Automatically checking vehicle status before a trip.
- Starting climate control remotely on cold days.
- Locking or unlocking the vehicle based on geofencing triggers.
- Retrieving vehicle location for fleet tracking.
The "Start Engine/Climate" operation specifically allows starting the engine or climate system with customizable options like enabling air control, defrost, setting heating temperature, and duration.
Properties
| Name | Meaning |
|---|---|
| VIN | Optional Vehicle Identification Number to target a specific vehicle. If empty, vehicle index is used. |
| Vehicle Index | Index of the vehicle to use when VIN is not provided (0-based). |
| Start Options | Collection of options for starting engine/climate: |
| - Air Control | Enable or disable climate control (boolean). |
| - Defrost | Enable or disable defrost function (boolean). |
| - Heating Temperature (°C) | Target temperature for climate start, between 16 and 32 °C (number). |
| - Duration (minutes) | How long to run the engine/climate, from 1 to 30 minutes (number). |
Output
The node outputs an array of JSON objects depending on the selected operation:
- listVehicles: Outputs an array of vehicles with fields like
vin,id, andnickname. - getStatus: Outputs detailed parsed vehicle status information.
- getLocation: Outputs current vehicle location data.
- getOdometer: Outputs odometer reading.
- lock / unlock: Outputs success confirmation.
- startEngine: Outputs result of starting engine/climate with applied options.
- stopEngine: Outputs result of stopping engine/climate.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential with username, password, region, language, and optionally a PIN for authentication with the BlueLinky service.
- Uses the external
bluelinkylibrary to communicate with Hyundai/Kia vehicle services. - Needs network access to BlueLinky API endpoints.
Troubleshooting
- Missing Credentials: The node will throw an error if the required API credentials are not configured.
- No Vehicles Found: If the account has no associated vehicles, an error is thrown.
- Invalid VIN or Vehicle Index: Errors occur if the specified VIN does not match any vehicle or the vehicle index is out of bounds.
- Operation Errors: Unknown operations or failures in API calls will result in descriptive errors.
- Timeouts or Network Issues: May cause failures in communication with the vehicle service; ensure stable internet connection.
To resolve issues:
- Verify API credentials are correctly set up.
- Confirm the VIN or vehicle index corresponds to a valid vehicle.
- Check network connectivity.
- Review error messages for specific details.
Links and References
- BlueLinky GitHub Repository – Library used for vehicle communication.
- Hyundai/Kia BlueLink official service documentation (access may require user account).
- n8n Documentation on creating and using custom nodes.