Setting up two-factor authentication (2FA) is an important step for securing your Retool account.
In some cases, when submitting the 2FA setup code, no error message appears in the UI. While this behavior is already tracked internally, here are some troubleshooting steps you can try in the meantime to move forward with your setup.
If you’re experiencing no response when hitting “Submit” at /two-factor-challenge-setup, here’s what might be happening:
- When you check your browser’s developer tools (Network tab), you may see a 422 Unprocessable Content error for the
/api/user/confirm2FASetupendpoint.
The good news is there are several steps you can try to resolve this issue.
Common Troubleshooting Steps
1. Incorrect 2FA Code
- Double-check the code in your authenticator app and make sure you’re entering it exactly as shown.
- Because codes are time-sensitive, even a short delay or mistyping can cause errors.
2. Delete 2FA Setup Attempts
- Clear any previous 2FA setup records and try again.
- This can help if cached or incomplete setup attempts are interfering.
3. Use Incognito Mode & Clear Cache
- Open Retool in an incognito window and/or clear your browser’s cache and cookies.
- This often resolves browser-specific issues that may block 2FA setup.
4. Check Time Settings
- 2FA codes are time sensitive.
- Make sure your 2FA device’s time matches your computer’s time and if needed, temporarily adjust your local machine’s time zone to match your authenticator device.
5. Try a Different Authenticator App
- If your current authenticator app isn’t working, try another, such as Duo Mobile
- Switching apps can sometimes resolve compatibility issues.
If none of the above steps work, don’t hesitate to reach out to us here! Provide details from your developer tools (such as the 422 error) and what steps you've tried so far to help speed up the investigation. 