Fordpass Home Assistant Integration 2025 (EV/PHEV/Petrol/Diesel)
[a fork of @itchannel and @SquidBytes]

Warning

Disclaimer — The use of this HA integration could lead to a (temporary) lock of your Fordpass account.

This integration is not officially supported by Ford, and as such, using this integration could result in your account being locked out!

Please be aware that I am developing this integration to the best of my knowledge and belief, but can't give a guarantee. Therefore, use this integration at your own risk!

• It's recommended to use/create a separate Fordpass account for this integration (see step-by-step procedure further below).
• It's recommended to use an update interval of 240 seconds or higher to prevent a lock of your Fordpass account.

Note

Since I own an EV (Mustang MachE 2023), I will focus on the features that are available for electrical vehicles, but of course I will try not to mess up the features for petrol or diesel vehicles. Please see also the 'I need you' section

Important

Unusual Integration Setup

Status Quo in spring/summer 2025: This integration requires an unusual setup process to be able to access the data of your vehicle. This is due to the fact that Ford has changed (once again) the access policies to the required backend APIs (and revoked the access to the APIs for individual developers).

The current implementation is based on API calls the original Fordpass App (for Android & iOS) performs, and it's some sort of reverse engineered.

This approach implies that when Ford is going to change something in their none-public/undocumented API, it's quite likely that the integration will break instantly.

It's impossible to predict when this will happen, but I will try to keep the integration up-to-date and working as long as possible, since I drive a Ford myself.

Fetch & Store Fordpass Access Token

During the integration setup, you will be guided through the process to obtain an access token for your vehicle in the context of your Fordpass account.

This should be a one-time process, and the access token will be stored in a file outside the custom integration directory (This is to prevent the access token from being deleted during updates of the integration itself). As already explaind, I can't give any guarantee that process will work in the future.

The overall setup process is described in short in the Installation section below, and in detail in the linked documentation.

Warning

This fork is not compatible with the original Fordpass integration from @itchannel and @SquidBytes

Before you can use this fork with your vehicle, you must have removed the original Fordpass integration from HA and must have deleted all configuration entries. Please be aware that it's quite likely that a configuration can be disabled!

Incompatible changes:

• The VIN has been added to all the entity names, to ensure that names stay unique in HA when you have multiple vehicles.
• The sensor attribute names do not contain spaces anymore to make post-processing easier. Additionally, all the attribute names are now using camelcase. This means that all attributes start with a lower-case character (don't let you fool by the HA user interface, which always will show the first character as upper-case).
• The access-token(s) is stored outside the custom integration

Additional enhancements:

• Additional Sensors for EV/PHEV vehicles
• Buttons to local/remote refresh data in HA
• Sensor to provide EVCC-Charging state see evcc.io website for details
• Translation of Entity names (DE/EN)
• Code cleanup and refactoring

Requirements

1. Your car must have the latest onboard modem functionality and have been registered/authorized with the fordpass application.
2. You need a Home Assistant instance (v2023.9 or higher) with the HACS custom integration installed.

Important

This is a HACS custom integration — not a Home Assistant Add-on. Don't try to add this repository as an add-on in Home Assistant.

The IMHO simplest way to install this integration is via the two buttons below ('OPEN HACS REPOSITORY ON MY HA' and 'ADD INTEGRATION TO MY HA').

Installation Instructions (3 Steps)

Step 1. HACS add the Integration

1. In HA HACS, you need to add a new custom repository (via the 'three dots' menu in the top right corner).
2. Enter https://github.com/marq24/ha-fordpass as the repository URL (and select the type Integration).
3. After adding the new repository, you can search for fordpass in the search bar.
4. Important there is already a default HACS fordpass integration — Please make sure to select the 'correct' one with the description: Fordpass integration for Home Assistant [fork optimized for EV's & EVCC].
5. Install the 'correct' (aka 'this') fordpass integration (v2025.5.0 or higher).
6. Restart HA.

Step 2. Setup the Integration

7. After the restart go to Settings -> Devices & Services area
8. Add the new integration Fordpass and follow the instructions:
   You will need to provide:
   • Your Fordpass Email/Account
   • Select a Fordpass Region (USA, EU, UK, AU) [it's expected that only 'USA' will work right now]

Step 3. The hard part — the Token Setup

The actual token request requires an external browser to get finally the Fordpass access token. [Yes this is for sure quite unusual process when setting up a HA integration, but it's the only way to get the token right now]

Please follow the steps:

1. Copy the URL listed in the first input field
2. Open a new browser (with enabled developer tools) and paste the copied URL it into your second browser
3. In this second browser: Enter your Fordpass credentials (again) and press the login button
4. Watch the developer tools Network-tab till you see the ?code= request (this request will fail, but it's not important)
5. Copy the full Request-URL from this ?code= request from the browser's developer tools and paste it in the HA integration setup Token field [you must copy the complete URL - so ist must start with fordapp://userauthorized/?code= ... ]

More details (how to deal with the browser developer tools) to obtain your token can be found in the docs.

Usage with EVCC

All information, how to use this integration as provider for Ford EV data can be found in a separate section in this repository.

Use of a separate Fordpass account is recommended

Tip

It's recommended to use a separate Fordpass account for this integration. This is to prevent any issues with the Fordpass account being locked due to the polling of the API.

Here is a short procedure how to create a second account:

1. Create a new Fordpass account with a different email address (and confirm the account by eMail) - It's important, that you can access this eMail account from your mobile phone with the installed FordPass App!
2. From the Fordpass app (logged in with your original account), you can select Settings from the main screen (at the bottom there are three options: Connected Services >, Location > & Settings >)
3. On the next screen select Vehicle Access (from the options: Phone As A Key >, Software updates > & Vehicle Access >)
4. Select Invite Driver(s) Invite and then enter the next screen the eMail address of the new account you created in step 1.
5. Now you can log out from the Fordpass app and log-in with the new account.
6. Wait till the invitation eMail arrives and accept the invitation with the button at the bottom of eMail.
7. Finally, you should have now connected your car to the new Fordpass account.
8. You can now log out again of the Fordpass app with your second account and re-login with your original Fordpass account.
9. You can double-check with a regular browser, that the car is now accessible with the new account by web.

Services

Clear Tokens

If you are experiencing any sign in issues, please trying clearing your tokens using the "clear_tokens" service call.

Poll API (local refresh)

This service allows you to manually refresh/poll the API without waiting the set poll interval. Handy if you need quicker updates e.g. when driving for gps coordinates

Request Update (remote refresh)

This service will contact the modem in the vehicle and request to sync data between the vehicle and the ford backends. Please note, that this will have an impact on the battery of your vehicle.

Sensors

Currently Working

Sensors may change as the integration is being developed

• Fuel Level
• EV-Battery Level (SOC)
• Odometer
• Lock/Unlock
• Oil Status
• Last known GPS Coordinates/Map
• Tyre Status
• Battery Status
• Ignition Status
• Alarm Status
• Individual door statuses
• Remote Start
• Window Status (only if supported by the vehicle)
• Last Car Refresh status
• Car Tracker (Location)
• Supports Multiple Regions
• Electric Vehicle Support
• TPMS Sensors
• Guard Mode (Only supported cars)
• Deep sleep status
• Fordpass messages and alerts

Want to report an issue?

Please use the GitHub Issues for reporting any issues you encounter with this integration. Please be so kind before creating a new issues, check the closed ones if your problem has been already reported (& solved).

To speed up the support process, you might like to already prepare and provide DEBUG log output. In the case of a technical issue, I would need this DEBUG log output to be able to help/fix the issue. There is a short tutorial/guide 'How to provide DEBUG log' here — please take the time to quickly go through it.

For this integration, you need to add:

logger:
  default: warning
  logs:
    custom_components.fordpass: debug

---

I need You!

This might be a quite unusual request, but I would like to ask you to consider supporting the testing of this integration by granting me access to your car data.

It's correct that this implies that you are willing to share your vehicle data (like the location) with me and I would fully understand if you are not willing to do so. But at least it must be allowed to ask. Since I can't afford to buy another Ford vehicle (nor do I actually have the space), it would be great if I would be able to test (besides with my EV, also) PEV's, DIESEL and GAS vehicles with this integration.

You can do this by adding my Fordpass account to your existing vehicle as it's described here in the section Use of a separate Fordpass account is recommended.

So if you are willing to help, please send me a short eMail and I will send you my Fordpass account eMail address, so you can add me to your vehicle (and can accept your invite). You can end the sharing at any time by removing my account from your vehicle in your Fordpass app.

Supporting the development

If you like this integration and want to support the development, please consider supporting me on GitHub Sponsors or BuyMeACoffee or PayPal.

Credits

• https://github.com/itchannel/fordpass-ha - Original fordpass integration by @itchannel and @SquidBytes

Credits (of the original integration)

• https://github.com/SquidBytes - EV updates and documentation
• https://github.com/clarkd - Initial Home Assistant automation idea and Python code (Lock/Unlock)
• https://github.com/pinballnewf - Figuring out the application ID issue
• https://github.com/degrashopper - Fixing 401 error for certain installs
• https://github.com/tonesto7 - Extra window statuses and sensors
• https://github.com/JacobWasFramed - Updated unit conversions
• https://github.com/heehoo59 - French Translation

Changelog

See the separate Updates file for the changelog.