# User Two-factor Success Event

Learn about the User Two-factor Success event.

> For the index of this section of the site, see [llms.txt](https://fusionauth.io/docs/llms.txt)

## User Two Factor Success

> **PLAN:** This feature requires [an Enterprise plan](https://fusionauth.io/docs/concepts/plans-and-limits/plans-features.md#enterprise-features).

Available since `1.68.0`

This event is generated when a two-factor successful code entry happens.

Event type

user.two-factor.success

### Event Scope

This is a tenant-scoped event.

It can be sent to all tenants or to one or more specified tenants. However, those tenants will not be sent events for other tenants, but only events related to themselves.

### Transaction Compatibility

This event is non-transactional. The operation will succeed regardless of the webhook response status code.

### Event Body

`event.applicationId`

*   Type: `UUID`

The unique Id of the Application for which the user has requested login. If the login request omits the **applicationId** or the user is not registered for the requested **applicationId** this value will not be returned in the event.

`event.clientRisk`

*   Type: `String`

The Intelligent MFA calculated client risk. The possible values are: `LOW`, `MEDIUM`, and `HIGH`.

`event.createInstant`

*   Type: `Long`

The [instant](https://fusionauth.io/docs/apis/data-types.md#instants) that the event was generated.

`event.id`

*   Type: `UUID`

The unique Id of the event. You may receive an event more than once based upon your transaction settings. This Id may be used to identify a duplicate event.

`event.messageType`

*   Type: `String`

The optional MFA message type used to complete the login request. The possible values are: `SMS` and `Voice`.

`event.method`

*   Type: `String`

The MFA method used to complete the login request. The possible values are: `authenticator`, `email`, `recoveryCode`, and `sms`.

`event.info.data`

*   Type: `Object`

An object that can hold any information about the event that should be persisted.

`event.info.deviceDescription`

*   Type: `String`

The description of the device associated with the event.

`event.info.deviceName`

*   Type: `String`

The device name associated with the event.

`event.info.deviceType`

*   Type: `String`

The type of device associated with the event.

`event.info.ipAddress`

*   Type: `String`

The source IP address of the event.

`event.info.location.city`

*   Type: `String`

The city where the event originated.

**Enterprise plan** To use event location data, you'll need [an Enterprise plan](https://fusionauth.io/docs/concepts/plans-and-limits/plans-features.md#enterprise-features).

`event.info.location.country`

*   Type: `String`

The country where the event originated.

**Enterprise plan** To use event location data, you'll need [an Enterprise plan](https://fusionauth.io/docs/concepts/plans-and-limits/plans-features.md#enterprise-features).

`event.info.location.latitude`

*   Type: `Double`

The latitude where the event originated.

**Enterprise plan** To use event location data, you'll need [an Enterprise plan](https://fusionauth.io/docs/concepts/plans-and-limits/plans-features.md#enterprise-features).

`event.info.location.longitude`

*   Type: `Double`

The longitude where the event originated.

**Enterprise plan** To use event location data, you'll need [an Enterprise plan](https://fusionauth.io/docs/concepts/plans-and-limits/plans-features.md#enterprise-features).

`event.info.location.region`

*   Type: `String`

The geographic location where the event originated.

**Enterprise plan** To use event location data, you'll need [an Enterprise plan](https://fusionauth.io/docs/concepts/plans-and-limits/plans-features.md#enterprise-features).

`event.info.location.zipcode`

*   Type: `String`

The zip code where the event originated.

**Enterprise plan** To use event location data, you'll need [an Enterprise plan](https://fusionauth.io/docs/concepts/plans-and-limits/plans-features.md#enterprise-features).

`event.info.os`

*   Type: `String`

The operating system associated with the event.

`event.info.userAgent`

*   Type: `String`

The user agent associated with the event.

`event.linkedObjectId`

*   Type: `UUID`
*   Available since `1.53.0`

The Id of the user related to this event.

`event.tenantId`

*   Type: `UUID`

The unique tenant identifier. This value may not be returned if not applicable.

`event.type`

*   Type: `String`

The event type, this value will always be `user.two-factor.success`.

`event.user`

*   Type: `Object`

The user that completed the login request. See the [Users API](https://fusionauth.io/docs/apis/users.md) for property definitions and example JSON

Example Event JSON

```json
{
  "event": {
    "applicationId": "134f7157-0252-4100-889e-8b3084b85660",
    "clientRisk": "MEDIUM",
    "createInstant": 1630383272048,
    "id": "0f2a3e31-d7c9-48dc-841a-b47ca4830773",
    "info": {
      "deviceName": "macOS Chrome",
      "deviceType": "BROWSER",
      "ipAddress": "127.0.0.1",
      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36"
    },
    "linkedObjectId": "afb7db63-2a73-4415-a7f1-b81a80ca4bea",
    "method": "authenticator",
    "tenantId": "30663132-6464-6665-3032-326466613934",
    "type": "user.two-factor.success",
    "user": {
      "active": true,
      "birthDate": "1981-06-04",
      "connectorId": "e3306678-a53a-4964-9040-1c96f36dda72",
      "data": {
        "Company": "PiedPiper",
        "PreviousCompany": "Aviato",
        "user_type": "iconclast"
      },
      "email": "example@fusionauth.io",
      "firstName": "Erlich",
      "id": "00000000-0000-0000-0000-000000000001",
      "insertInstant": 1630083026349,
      "lastLoginInstant": 1630383233716,
      "lastName": "Bachman",
      "lastUpdateInstant": 1630083026349,
      "memberships": [],
      "passwordChangeRequired": false,
      "passwordLastUpdateInstant": 1630083026431,
      "preferredLanguages": [],
      "registrations": [],
      "tenantId": "30663132-6464-6665-3032-326466613934",
      "twoFactor": {
        "methods": [],
        "recoveryCodes": []
      },
      "usernameStatus": "ACTIVE",
      "verified": true
    }
  }
}
```

Related

[Events User Two-factor Challenge Event Learn about the User Two-factor Challenge event. mfa webhookfusionauth userwebhook event](https://fusionauth.io/docs/events/reference/user/user-two-factor-challenge.md)

[Events User Two-factor Failed Attempt Event Learn about the User Two-factor Failed Attempt event. mfa webhookfusionauth userwebhook event](https://fusionauth.io/docs/events/reference/user/user-two-factor-failed-attempt.md)

[Events User Two-factor Method Add Event Learn about the User Two-factor Method Add event. mfa webhookfusionauth userwebhook event](https://fusionauth.io/docs/events/reference/user/user-two-factor-method-add.md)

[Events User Two-factor Method Remove Event Learn about the User Two-factor Method Remove event. mfa webhookfusionauth userwebhook event](https://fusionauth.io/docs/events/reference/user/user-two-factor-method-remove.md)
---

## Other pages in User

> For the full index of this section, see [Events](https://fusionauth.io/docs/llms-events.txt).

- [User Login Failed Event](https://fusionauth.io/docs/events/reference/user/login/user-login-failed.md): Learn about the User Login Failed event.
- [User Login Id Duplicate Create Event](https://fusionauth.io/docs/events/reference/user/login/user-login-id-duplicate-create.md): Learn about the User Login Id Duplicate Create event.
- [User Login Id Duplicate Update Event](https://fusionauth.io/docs/events/reference/user/login/user-login-id-duplicate-update.md): Learn about the User Login Id Duplicate Update event.
- [User Login New Device Event](https://fusionauth.io/docs/events/reference/user/login/user-login-new-device.md): Learn about the User Login New Device event.
- [User Login Success Event](https://fusionauth.io/docs/events/reference/user/login/user-login-success.md): Learn about the User Login Success event.
- [User Login Suspicious Event](https://fusionauth.io/docs/events/reference/user/login/user-login-suspicious.md): Learn about the User Login Suspicious event.
- [User Password Breach Event](https://fusionauth.io/docs/events/reference/user/password/user-password-breach.md): Learn about the User Password Breach event.
- [User Password Reset Send Event](https://fusionauth.io/docs/events/reference/user/password/user-password-reset-send.md): Learn about the User Password Reset Send event.
- [User Password Reset Start Event](https://fusionauth.io/docs/events/reference/user/password/user-password-reset-start.md): Learn about the User Password Reset Start event.
- [User Password Reset Success Event](https://fusionauth.io/docs/events/reference/user/password/user-password-reset-success.md): Learn about the User Password Reset Success event.
- [User Password Update Event](https://fusionauth.io/docs/events/reference/user/password/user-password-update.md): Learn about the User Password Update event.
- [User Registration Create Complete Event](https://fusionauth.io/docs/events/reference/user/registration/user-registration-create-complete.md): Learn about the User Registration Create Complete event.
- [User Registration Create Event](https://fusionauth.io/docs/events/reference/user/registration/user-registration-create.md): Learn about the User Registration Create event.
- [User Registration Delete Complete Event](https://fusionauth.io/docs/events/reference/user/registration/user-registration-delete-complete.md): Learn about the User Registration Delete Complete event.
- [User Registration Delete Event](https://fusionauth.io/docs/events/reference/user/registration/user-registration-delete.md): Learn about the User Registration Delete event.
- [User Registration Update Complete Event](https://fusionauth.io/docs/events/reference/user/registration/user-registration-update-complete.md): Learn about the User Registration Update Complete event.
- [User Registration Update Event](https://fusionauth.io/docs/events/reference/user/registration/user-registration-update.md): Learn about the User Registration Update event.
- [User Registration Verified Event](https://fusionauth.io/docs/events/reference/user/registration/user-registration-verified.md): Learn about the User Registration Verified event.
- [User Action Event](https://fusionauth.io/docs/events/reference/user/user-actions.md): Learn about the User Action event.
- [User Bulk Create Event](https://fusionauth.io/docs/events/reference/user/user-bulk-create.md): Learn about the User Bulk Create event.
- [User Create Complete Event](https://fusionauth.io/docs/events/reference/user/user-create-complete.md): Learn about the User Create Complete event.
- [User Create Event](https://fusionauth.io/docs/events/reference/user/user-create.md): Learn about the User Create event.
- [User Deactivate Event](https://fusionauth.io/docs/events/reference/user/user-deactivate.md): Learn about the User Deactivate event.
- [User Delete Complete Event](https://fusionauth.io/docs/events/reference/user/user-delete-complete.md): Learn about the User Delete Complete event.
- [User Delete Event](https://fusionauth.io/docs/events/reference/user/user-delete.md): Learn about the User Delete event.
- [User Email Update Event](https://fusionauth.io/docs/events/reference/user/user-email-update.md): Learn about the User Email Update event.
- [User Email Verified Event](https://fusionauth.io/docs/events/reference/user/user-email-verified.md): Learn about the User Email Verified event.
- [User Identity Provider Link Event](https://fusionauth.io/docs/events/reference/user/user-identity-provider-link.md): Learn about the User Identity Provider Link event.
- [User Identity Provider Unlink Event](https://fusionauth.io/docs/events/reference/user/user-identity-provider-unlink.md): Learn about the User Identity Provider Unlink event.
- [User Identity Verified Event](https://fusionauth.io/docs/events/reference/user/user-identity-verified.md): Learn about the User Identity Verified event.
- [User Reactivate Event](https://fusionauth.io/docs/events/reference/user/user-reactivate.md): Learn about the User Reactivate event.
- [User Two-factor Challenge Event](https://fusionauth.io/docs/events/reference/user/user-two-factor-challenge.md): Learn about the User Two-factor Challenge event.
- [User Two-factor Failed Attempt Event](https://fusionauth.io/docs/events/reference/user/user-two-factor-failed-attempt.md): Learn about the User Two-factor Failed Attempt event.
- [User Two-factor Method Add Event](https://fusionauth.io/docs/events/reference/user/user-two-factor-method-add.md): Learn about the User Two-factor Method Add event.
- [User Two-factor Method Remove Event](https://fusionauth.io/docs/events/reference/user/user-two-factor-method-remove.md): Learn about the User Two-factor Method Remove event.
- [User Update Complete Event](https://fusionauth.io/docs/events/reference/user/user-update-complete.md): Learn about the User Update Complete event.
- [User Update Event](https://fusionauth.io/docs/events/reference/user/user-update.md): Learn about the User Update event.