Hi to all developers!
We’ve released an upgrade to monday’s OAuth authorization flow that removes one of the top pain points you flagged: admins getting stuck when your app isn’t yet installed on their account.
What’s changed?
Previously, if a monday admin started your OAuth flow from outside monday and the app wasn’t installed, the flow hit a dead end. You had to send docs, the admin had to backtrack and install, then retry the flow.
Starting today, simply add the query parameter force_install_if_needed=true to your authorization-request redirect URL, and we’ll automatically:
- Detect that the app isn’t installed.
- Show the admin an install screen.
- Jump straight back into the OAuth consent step once installation is complete.
One smooth, uninterrupted journey.
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
Impact on your app
- Higher conversion: fewer admins drop off mid-flow.
- Less support overhead: no more “first install the app, then try again” guides.
- Happier customers: they get connected in seconds, not minutes.
Heads-up: if a non-admin user starts the flow
We’ll still require an admin to install the app. Automatic “request install” isn’t available yet. Make sure your UI or copy sets expectations (e.g., “Ask an admin to install the app first”).
Action items for you
- Add force_install_if_needed=true to the redirect URL from your product.
- Test the flow with an account where the app is not installed to confirm the new experience.
- Update any setup docs and tooltips to reflect the new simpler flow and non-admin fallback).
That’s it! Questions, feedback, or edge-case horror stories? Drop them on the monday Community or open a ticket.