Application Credentials - Request for better documentation somewhere

First I want to thank everyone who contributes to building a great environment with Home Assistant. I am so grateful for the brilliant mind who help to find ways to integrate home assistant with various 3rd party products.

Having said that, I must share some frustration. Now on two occasions, I have found myself reading through dozens of community postings to understand how to generate OAuth Client ID and Client secret. It has taken hours (now twice) to uncover (somewhere) the url we can use on application websites looking to grant OAuth credentials. They seem to always look for a server website (which obviously we can not use our local home assistant URL.

I found on two separate sites, the url:

Link to OAuth2 Authorize Callback – My Home Assistant’. \https://my.home-assistant.io/redirect/oauth\

can (should) be specified at an apps creditial site to get OAuth Client ID and Secret.

I just used that site to integrate FitBit into home assistant I used it for every url that credential site requested, and was successfully able to create the credentials to link FitBit to HA. I also used that URL previously to connect to Google for Google Nest.

All the HA documentation sites I have searched have never mentioned this url. First question, is it sanctioned and actually recommended to be the external site we should use? If so, then here is my ask… Why can’t this URL be specified somewhere we can find without searching for hours?

When I go to SETTINGS->INTEGRATION and then click on the 3 dots on the right corner to Add application credentials, then request to create a new one… the pop up screen shows a URL to " View application credentials documentation". I’m sorry if I am offending anyone who has taken the time to write that documentation, but that site really would benefit from more detail.

Wouldn’t it be possible to have the url (Link to OAuth2 Authorize Callback – My Home Assistant) mentioned in that page along with the steps on what is typically needed to created the OAuth credentials?

I don’t like to pass the buck, and would be willing to help work on that documentation, however, I don’t feel I understand the process sufficiently to do it justice. I have just fell upon it twice at this point through the good grace of others in the community mentioning it in various postings.

Maybe I am barking up the wrong tree here and this URL isn’t official sanctioned, OR is documented somewhere - but no where where I have found trying to do this task.

Just a thought.