We’ve upgraded monday’s OAuth flow to prevent admins from getting stuck when an app hasn't been installed yet. This update helps boost conversion rates, reduce support, and get customers connected to your app faster.

By adding the query parameter force_install_if_needed=true to your authorization-request redirect URL, monday will automatically:

Detect when the app isn’t installed
Prompt the admin to install it
Continue to the OAuth consent step once installation is complete

Note: An admin must still manually install the app since automated installation requests aren't yet supported. Be sure to update your UI or messaging accordingly (e.g., “Ask an admin to install the app first”).

Example request

GET https://auth.monday.com/oauth2/authorize  
  ?client_id=<YOUR_CLIENT_ID>  
  &redirect_uri=https://yourapp.com/oauth/callback  
  &scope=  
  &state=<CSRF_TOKEN>  
  &force_install_if_needed=true

Next steps

Add force_install_if_needed=true to your authorization redirect URL.
Test the flow on an account where the app isn't installed yet.
Update any setup guides, tooltips, or in-app copy to reflect the simplified flow. Remember to clarify that the admin installation is still required!