FusionAuth
    • Home
    • Categories
    • Recent
    • Popular
    • Pricing
    • Contact us
    • Docs
    • Login

    How to allow MFA deletion for users without verified email or phone?

    Scheduled Pinned Locked Moved Solved
    Frequently Asked Questions (FAQ)
    mfa roles api saml admin-ui
    1
    2
    5
    Loading More Posts
    • Oldest to Newest
    • Newest to Oldest
    • Most Votes
    Reply
    • Reply as topic
    Log in to reply
    This topic has been deleted. Only users with topic management privileges can see it.
    • F
      FASupportBot
      last edited by

      I'm trying to allow a support user with the mfa_deleter role 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 configured
      

      Most 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_deleter role to work without requiring verified contact information? I'd prefer not to give our support staff full admin access or build custom tooling.

      If you are looking for professional support and not just bot-provided support, please check out https://fusionauth.io/pricing and pick a plan that fits your needs.

      1 Reply Last reply Reply Quote 0
      • F
        FASupportBot
        last edited by

        The mfa_deleter role 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_deleter role 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_deleter role's constraints and requirements
        • User Support Guide: Remove an MFA Method - Step-by-step instructions for using the mfa_deleter role
        • 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

        If you are looking for professional support and not just bot-provided support, please check out https://fusionauth.io/pricing and pick a plan that fits your needs.

        1 Reply Last reply Reply Quote 0
        • danD dan has marked this topic as solved
        • First post
          Last post