[GUIDE] How to get the Token (New Login Method) & Battery Safe Settings (2026)

[danchojrin]

Body:

Hi everyone,

After struggling with the "Blocked by Web Firewall" error when trying to get the token via browser developer tools, I found a working solution using the script by @RustyDust and a specific configuration to keep the 12V battery safe.

Here is the step-by-step guide for Mac users (and applicable to others) to get it working in minutes.

Part 1: Getting the Refresh Token (The "Web Firewall" Fix)

The standard browser method doesn't work anymore for many accounts. You need to use the script that simulates the official App login.

For Mac Users (avoiding python environment errors):

Open your Terminal and run these commands one by one:

Bash

# 1. Download the script

curl -o ~/Downloads/bluelinktoken.py https://raw.githubusercontent.com/RustyDust/bluelink_refresh_token/main/bluelinktoken.py

# 2. Go to downloads

cd ~/Downloads
# 3. Create a virtual environment (to avoid "externally-managed-environment" errors)

python3 -m venv hyundai_env
# 4. Activate the environment

source hyundai_env/bin/activate
# 5. Install dependencies

pip install requests colorama selenium webdriver-manager
# 6. Run the script

python bluelinktoken.py --brand hyundai

• The script will open a Chrome window automatically.

• Log in with your credentials.

• Do not touch anything else. The script will capture the token and close the window.

• Copy the Refresh Token from the terminal output.

---

Part 2: "Battery Safe" Configuration

To prevent the 12V battery drain, use these exact settings in Home Assistant. This ensures the car is never woken up automatically, but HA still gets updates from the cloud cache every 30 mins.

Setting	Value	Reason
Scan Interval	30	Fetches data from cloud cache (Zero battery usage).
Force Update Interval	50000	Sets the wake-up interval to ~34 days (effectively never).
No Force Update Start	00:00	Blocks forced updates starting at midnight.
No Force Update End	23:00	Blocks forced updates until 11 PM.
Enable Force Update	OFF	Keep the switch disabled if available.

Result:

• Updates: You get updated status every time you use the car (it pushes data to cloud) or every 30 mins from cache.

• Battery: The car stays in deep sleep mode when parked.

Big thanks to @RustyDust for the script! Hope this helps anyone stuck with the new login blocks.

---

🚀

[Uschinator]

Worked like a charm. Thank You :-)

[erikhuiberts]

Doesn't work for me unfortunately, after successful login I'm redirected to https://www.hyundai.com/nl/nl/clicktobuy/ctb and browser is not closed.
Any ideas?

[cdnninja]

Could you check for me if:https://github.com/Hyundai-Kia-Connect/hyundai_kia_connect_api/tree/master/Hyundai%20Token%20Solution

works or not? I am interested to get this into the repo to make sure a usable solution always exists in the repo.

[erikhuiberts]

Yes! Worked under Windows 10. Many thanks!

[isarrider]

@danchojrin it worked for me under Ubuntu - thx!

[tginther]

I'm in the US. I have tried the above solution on a Mac and after putting in the account credentials in Chrome, doing the captcha and pressing login, it does not accept the login and returns me to the login screen again. I cannot successfully log in using this Chrome session.

If I go to Safari or Chrome, navigate to the Hyundai site, I can log in with no issues. Any ideas what I can try?