Okta Verify / SMS MFA – Troubleshooting Guide

Link to article

https://support.okta.com/help/s/article/Okta-VerifySMS-Troubleshooting-Guide?language=en_US

Overview

This guide outlines common issues encountered with Okta Verify and SMS-based multi-factor authentication (MFA) and provides troubleshooting steps to restore access.

Problems typically relate to:

• Verification codes not working

• SMS messages not being received

• Device changes

• Activation failures

• Time synchronisation issues

Applies to

• Okta MFA

• Okta Verify (iOS / Android)

• SMS authentication factor

Common Issues and Resolutions

1. SMS Code Not Received

Possible causes

• Incorrect phone number

• Mobile carrier filtering

• Device has no signal

• SMS blocked by handset

Resolution

• Confirm the phone number in Okta is correct (including country code).

• Ask the user to check signal and SMS capability.

• Ensure SMS is not blocked or filtered.

• Attempt to resend the code.

• If persistent, re-enrol the SMS factor.

2. Okta Verify Code Not Working

Possible causes

• Device time out of sync

• User entering an expired code

• App not fully activated

Resolution

• Ensure automatic date and time is enabled on the device.

• Ask the user to generate a new code and enter it immediately.

• Re-activate Okta Verify if necessary.

Time drift is one of the most common causes of invalid TOTP codes.

3. Okta Verify Push Notification Not Received

Possible causes

• No internet connection

• Push notifications disabled

• Device battery optimisation blocking background activity

Resolution

• Confirm device has mobile data or Wi-Fi.

• Check notification permissions for Okta Verify.

• Disable aggressive battery optimisation for the app.

• Use manual code entry as a temporary workaround.

4. New or Replaced Device

If a user changes or resets their phone:

• Existing Okta Verify enrolment will no longer work.

• MFA must be reset or re-enrolled.

Resolution

• An administrator resets the user’s MFA factors.

• User re-enrols Okta Verify or SMS factor during next login.

5. Activation QR Code Not Working

Possible causes

• QR code expired

• Activation link reused

• Browser session timeout

Resolution

• Generate a new activation QR code.

• Ensure activation is completed immediately.

• Avoid reusing old enrolment links.

Impact

If MFA fails:

• Users cannot log in to protected services.

• Access to business systems may be blocked.

• Support intervention may be required to reset factors.

Action Required

• Identify which MFA factor is failing (SMS, push, code).

• Confirm device time and connectivity.

• Re-enrol the factor if needed.

• Escalate to an administrator for MFA reset if the user is locked out.

Additional Information

• Encourage users to enrol at least two MFA methods where possible.

• Ensure phone numbers are kept up to date.

• Consider using Okta Verify push or TOTP instead of SMS where higher reliability is required.