BlueLinky icon

BlueLinky

Control Hyundai/Kia vehicles via the bluelinky library
Join our community

Actions7

Overview

This node integrates with Hyundai/Kia vehicles via the BlueLinky library, allowing users to remotely control and query vehicle status. Specifically, the Stop Engine/Climate operation stops the engine or climate control system of a selected vehicle.

Common scenarios for this operation include:

  • Remotely turning off the engine or climate system after use.
  • Automating vehicle shutdown as part of a workflow (e.g., after parking).
  • Ensuring the vehicle is not running unnecessarily to save fuel or battery.

Practical example: After remotely starting the engine or climate control for pre-conditioning, you can use this operation to stop it once the desired temperature or time has elapsed.

Properties

Name Meaning
VIN Optional Vehicle Identification Number to target a specific vehicle. If empty, the vehicle index is used instead.
Vehicle Index Index number of the vehicle to use when VIN is not provided. Must be 0 or greater.

Output

The output JSON contains the response from the vehicle's stop command. Typically, it includes a success indicator or relevant status message confirming that the engine/climate system was stopped.

Example output structure:

{
  "success": true
}

If no explicit response is returned by the vehicle API, a default success message is provided.

No binary data output is generated by this operation.

Dependencies

  • Requires an active BlueLinky API credential with username, password, region, language, and optionally a PIN.
  • The node depends on the bluelinky npm package to communicate with Hyundai/Kia vehicles.
  • Proper network connectivity and valid credentials are necessary to interact with the vehicle.

Troubleshooting

  • Missing Credentials Error: If the BlueLinky API credentials are not set or invalid, the node will throw an error indicating missing credentials. Ensure credentials are configured correctly in n8n.
  • Vehicle Not Found: If the specified VIN does not match any vehicle in the account, or the vehicle index is out of range, an error will be thrown. Verify the VIN or index corresponds to a vehicle linked to your account.
  • No Vehicles Found: If the account has no vehicles registered, operations cannot proceed.
  • API Communication Issues: Network problems or incorrect credentials may cause login failures or command errors.
  • Unknown Operation: If an unsupported operation is requested, the node throws an error specifying the unknown operation.

To resolve these issues:

  • Double-check credentials and vehicle identifiers.
  • Confirm vehicle availability in the BlueLinky account.
  • Ensure stable internet connection.
  • Review error messages for specific guidance.

Links and References

Discussion