Skip to content

OBTAINING_TOKEN.md

Latest commit

 

History

History
90 lines (60 loc) · 4.74 KB

OBTAINING_TOKEN.md

File metadata and controls

90 lines (60 loc) · 4.74 KB
Raw

Half-manual Login Flow

This method does require some manual steps, including the usage of the developer tools! of your browser (running on a Desktop/Laptop - using a mobile device will not work!)

Warning

Although this has been tested multiple times (in January–June 2025 and re-tested in June 2026), It can't be guaranteed the method will last as Ford is consistently making changes!

Note

This process requires at least the 2025.10.2 version of this fordpass integration.

Step I:

  1. In Home Assistant: Enter your Fordpass username
  2. You should select your region (where you have registered your FordPass account).

image

Step II:

  1. Copy the URL that has been generated and paste it in your additional/separate browser. You might like to use a private/incognito window for this.

Important

You must do this on a Destop/Laptop browser that has Developer tools available. Do NOT try to do this with your tablet or phone.

Ensure you have enabled the Developer tools before pressing "log in" as you will be required to capture a header once logged in!

As an alternative, you might also like to use Firefox – but the capturing of the URL works slightly different than described here – please refer to the Firefox specific instructions.:

Tip

JosephBlock has created a separate tool that supports you in the access-token-code-acquire-process, which makes the use of the browser developer tools obsolete. So if you don't mind installing a small helper application on your local computer, you can get the tool from here: https://github.com/JosephBlock/fordapp-handler.

Additionally, you can find a brief introduction in the GitHub Discussions.

image

  1. In your second/separate browser (where you paste the URL), the Ford Login dialog should be displayed.

Tip

Again, just as a reminder – there is a 3rd party tool from JosephBlock that can help you with this process.

  1. IMPORTANT: Now open the developer Tools of your desktop/laptop browser and select the Network tab as the active view.

    Windows/Linux:

    • Press F12, or
      • Right-click anywhere on the page → "Inspect", or
      • Press Ctrl+Shift+I

    Mac:

    • Press Cmd+Option+I, or
      • Right-click anywhere on the page → "Inspect Element"


    A panel will appear at the bottom or side of your browser window.


    Find the Network Tab

    1. Look at the top of the developer tools panel
    2. Click on the "Network" tab
      • It might be between other tabs like "Elements", "Console", "Sources"

  2. Enter your FordPass credentials and click Sign In.

Note

After you have pressed the login button, the Ford Login website will just show a spinner and will not continue to load — this is the intended behavior! At this point you are able to obtain the code by using the browser tools (see next step 4).

webrequst

  1. Now look into the Network tab of the Browsers developer tools you just have opened in step 3. In the following the Chrome/Egde method is described [for Firefox please refer to the Firefox specific instructions linked above]

    • The last request (probably already showed in red) is the one we are interested in... Since this last request contains the code we must capture for the integration.

    • Do a right-click on that line that should start with code?=... (in the Name Column)

    • From the context menu select Copy > (which will open another sub-menu)

    • From the sub-menu select Copy URL

    • The copied content should look similar to the following string, starting with fordapp:// (or lincolnapp://):

    • fordapp://userauthorized/?code=eyJraWQiOiItSm9pdi1OX1ktUWNsa***************************

    • Ensure you capture the entire string (copy the raw output and not the wrapped text)

    • You then can close the Ford login browser window

Note

Again - the Ford login website will not fully loaded. The login page will just continue to spin.

webrequst

Step III:

  • Once you've entered the full token request URL token back in the home assistant integration setup dialog, the integration should go off and get you a new set of tokens and then ask what vehicles you want to add.