How to allow MFA deletion for users without verified email or phone?
-
I'm trying to allow a support user with the
mfa_deleterrole to remove MFA from users in the Admin UI. However, when attempting to delete MFA methods, they receive this error:cannot delete multi-factor method: no notification can be sent to this user. Ensure the user has a verified email address or phone number and that the correct templates are configuredMost of our users authenticate via SAML or social federated logins and do not have verified email addresses or phone numbers in FusionAuth.
We don't need to send notification emails when MFA is removed — we just need the ability to remove MFA for these users. Is there a way to allow the
mfa_deleterrole to work without requiring verified contact information? I'd prefer not to give our support staff full admin access or build custom tooling. -
The
mfa_deleterrole has hard requirements that cannot be bypassed. To remove MFA methods using this role, the target user must be notifiable through at least one verified primary identity:- Verified email + configured
tenant.emailConfiguration.adminTwoFactorMethodRemoveEmailTemplateId, OR - Verified phone number + configured
tenant.phoneConfiguration.adminTwoFactorMethodRemoveTemplateId
These requirements are by design and cannot be adjusted. The
mfa_deleterrole includes these safeguards to reduce the risk of abuse—when an MFA method is removed via this role, FusionAuth sends a notification to the affected user, so they must have a verified communication channel available.Workarounds
You have two options to remove MFA for users without verified contact information:
1. Use the Admin role
Users with the Admin role are not subject to these verification requirements and can remove MFA methods from any user in the Admin UI.
2. Use the API
Remove MFA methods programmatically using the Update a User API:
PATCH /api/user/{userId} Authorization: <your-api-key> Content-Type: application/json { "user": { "twoFactor": { "methods": [] } } }This approach allows you to build a custom support tool that removes MFA without granting full admin privileges to support staff.
Related Documentation
- The mfa_deleter Role - Details on the
mfa_deleterrole's constraints and requirements - User Support Guide: Remove an MFA Method - Step-by-step instructions for using the
mfa_deleterrole - Update a User API - API documentation for updating user properties, including MFA methods
- Admin Roles - Complete list of FusionAuth Admin UI roles and their permissions
- Admin Two-Factor Authentication Method Removed Email Template - Template used for notifications when admin removes MFA
- Admin Two-Factor Authentication Method Removed SMS Template - SMS template for MFA removal notifications
- Verified email + configured
-
D dan has marked this topic as solved