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 their vehicles. The "Unlock" operation specifically sends a command to unlock the vehicle's doors.

Common scenarios where this node is beneficial include:

  • Remotely unlocking your car for guests or family members.
  • Integrating vehicle access control into home automation workflows.
  • Providing remote assistance by unlocking the vehicle without physical keys.

Practical example: A user can trigger this node in an automation workflow to unlock their car when they arrive home, based on geolocation or other triggers.

Properties

Name Meaning
VIN Optional Vehicle Identification Number to target a specific vehicle. If empty, the vehicle index will be used.
Vehicle Index Index of the vehicle to use when VIN is not provided (0-based).

Output

The output JSON contains the response from the vehicle unlock command. Typically, it includes a success indicator:

{
  "success": true
}

If the unlock command does not return data, the node outputs { "success": true } by default to indicate the action was triggered.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for the BlueLinky API, including username, password, region, language (optional), and PIN (optional).
  • The node depends on the bluelinky npm package to communicate with Hyundai/Kia vehicles.
  • Proper configuration of these credentials in n8n is necessary before using the node.

Troubleshooting

  • Missing Credentials: The node throws an error if BlueLinky credentials are not set up. Ensure you have configured the required API authentication details.
  • Vehicle Not Found: If the specified VIN or vehicle index does not correspond to any vehicle in the account, an error is thrown. Verify the VIN or index is correct.
  • Vehicle Index Out of Bounds: Using a vehicle index outside the range of available vehicles causes an error. Check the number of vehicles linked to your account.
  • API Errors: Network issues or invalid credentials may cause login or command failures. Confirm network connectivity and credential validity.
  • Unknown Operation: If an unsupported operation is selected, the node will throw an error indicating the operation is unknown.

Links and References

Discussion