# User Action Event

Learn about the User Action event.

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

## User Action

This event is generated when a User Action is taken on a user and when temporal actions transition between phases.

A temporal action is one that has a start time and a duration. When a phase transition occurs for a temporal action, an event will be sent to the webhook. See the **event.phase** in the message body.

Event type

user.action

### Event Scope

Prior to version `1.37.0` this was a tenant- or application-scoped event. It can be sent to all applications or to one or more specified applications.

The ability to limit the generation of an event for only certain applications is legacy functionality and is removed as of version `1.37.0`. In earlier versions, you almost certainly want to enable this event at the tenant level and optionally filter on the **tenantId** when consuming the event.

In version `1.37.0` and later this is a tenant-scoped event. It can be sent to all tenants or to one or more specified tenants. Those tenants will only be sent events related to their tenant. You can optionally also filter on the **applicationId** when consuming the event.

### Transaction Compatibility

This event is transactional. The final state of the operation which caused the webhook is not persisted to FusionAuth until after the webhook finishes; [learn more](https://fusionauth.io/docs/events/webhooks/writing-a-webhook.md#calling-fusionauth-apis-in-webhooks)

### Event Body

`event.action`

*   Type: `String`

This parameter specifies the name of the action that is occurring.

`event.actionId`

*   Type: `UUID`

This parameter specifies the unique Id of the action that is occurring.

`event.actioneeUserId`

*   Type: `UUID`

This parameter specifies the unique identifier of the user the action is being performed on.

`event.actionerUserId`

*   Type: `UUID`

This parameter specifies the Id of the User that performed the action that resulted in the notification being sent. If the action was initiated by FusionAuth this value will not be provided.

`event.applicationIds`

This parameter if provided specifies the scope of the User Action. When an Action is scoped to one or more Applications the Application Ids will be provided in this parameter.

`event.comment`

*   Type: `String`

An optional comment left to possibly indicate why the action was taken, modified or canceled.

`event.createInstant`

*   Type: `Long`

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

`event.email`

*   Type: `Object`

When the action is configured to send the email in the event body, FusionAuth will render the email and provide the result in the event body. This can be used to send an email through a third party provider. See Example POST body below for fields.

`event.emailedUser`

*   Type: `Boolean`

This parameter will indicate if FusionAuth has already sent an email to the user as a result of this event. When `true` an email was sent to the user, and if `false` an email was not sent to the user.

`event.expiry`

*   Type: `Long`

The [instant](https://fusionauth.io/docs/apis/data-types.md#instants) that the action will expire, if the action expires.

`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.info.data`

*   Type: `Object`
*   Available since `1.30.0`

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

`event.info.deviceDescription`

*   Type: `String`
*   Available since `1.30.0`

The description of the device associated with the event.

`event.info.deviceName`

*   Type: `String`
*   Available since `1.30.0`

The device name associated with the event.

`event.info.deviceType`

*   Type: `String`
*   Available since `1.30.0`

The type of device associated with the event.

`event.info.ipAddress`

*   Type: `String`
*   Available since `1.27.0`

The source IP address of the event.

`event.info.location.city`

*   Type: `String`
*   Available since `1.30.0`

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`
*   Available since `1.30.0`

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`
*   Available since `1.30.0`

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`
*   Available since `1.30.0`

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`
*   Available since `1.30.0`

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`
*   Available since `1.30.0`

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`
*   Available since `1.30.0`

The operating system associated with the event.

`event.info.userAgent`

*   Type: `String`
*   Available since `1.30.0`

The user agent associated with the event.

`event.linkedObjectId`

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

The Id of the user impacted by this event.

`event.localizedAction`

*   Type: `String`

This parameter specifies the localized version of the **action** field, based on the user's preferred languages.

`event.localizedDuration`

*   Type: `String`

The duration of the action in a human readable format that is localized based on the user's preferred languages.

`event.localizedOption`

*   Type: `String`

This parameter specifies the localized version of the **option** field, based on the user's preferred languages.

`event.localizedReason`

*   Type: `String`

This parameter specifies the localized reason of the **reason** field, based on the user's preferred languages.

`event.notifyUser`

*   Type: `Boolean`

This parameter specifies whether the user should be notified. FusionAuth will only set this value based upon the event configuration, it is simply an indicator to the event consumer to notify the user.

`event.option`

*   Type: `String`

An optional value to provide additional context to the Action. This value is free form and defined by the User Action.

`event.phase`

*   Type: `Boolean`

If the Action is temporal, this parameter will be provided to indicate the current phase of the action. The following are the possible Action states:

*   `start` - The event has started.
*   `modify` - The event has been modified.
*   `cancel` - The event has been canceled, the `end` phase will not be reached.
*   `end` - The event has ended.

When the action is started by an admin, the phase will be "start". If an admin changes the duration of the action, the phase will be "modify". If an admin cancels an action it will be "cancel" or the action expires, the phase will be "end". If the action is key-based, the phase will be "start".

`event.reason`

*   Type: `String`

The reason the admin selected. Reasons may be configured in the FusionAuth UI, navigate to Settings -> User Actions -> Reasons . This value will be omitted when no reasons are selected (or configured).

`event.reasonCode`

*   Type: `String`

The reason code the admin selected. Reasons may be configured in the FusionAuth UI, navigate to Settings -> User Actions -> Reasons . This value will be omitted when no reasons are selected (or configured).

`event.tenantId`

*   Type: `UUID`
*   Available since `1.8.0`

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.action`.

Example Event JSON

```json
{
  "event": {
    "action": "Mute",
    "actionId": "8c10cd8d-251b-4ebc-9171-6a7a2e8ed390",
    "actioneeId": "32ac49fe-1f7f-40b6-a3a1-02611a10945a",
    "actionerId": "1219c8e2-c0c2-4efc-9323-6ee9062e9c1f",
    "applicationIds": [
      "2a6972a9-d332-458f-9c11-aa0eb74cfefc",
      "a1d7c8d2-be38-4530-8c61-b32245f94f0c",
      "def77957-1818-4fd5-b052-004777acb6fa",
      "96ebce2f-f9c0-44f6-a92f-6f476e08b678",
      "563215b9-b819-4ec5-b983-88174f26e390"
    ],
    "comment": "a comment",
    "createInstant": 1505762615056,
    "email": {
      "attachments": [],
      "bcc": [],
      "cc": [],
      "from": {
        "address": "moderator@yourorganization.com",
        "display": "Moderator"
      },
      "html": "<p>Please review the code of conduct to avoid being removed from the community.</p>",
      "replyTo": {
        "address": "no-reply@yourorganization.com",
        "display": "no-reply@yourorganization.com"
      },
      "subject": "You've received a Misconduct action",
      "text": "Please review the code of conduct to avoid being removed from the community.",
      "to": [
        {
          "address": "Allan249@example.com",
          "display": "Allan"
        }
      ]
    },
    "emailedUser": false,
    "expiry": 1408554564119,
    "id": "e502168a-b469-45d9-a079-fd45f83e0406",
    "localizedAction": "Mute",
    "localizedDuration": "2 days",
    "localizedOption": "soft",
    "localizedReason": "Misconduct",
    "notifyUser": true,
    "option": "soft",
    "phase": "start",
    "reason": "Misconduct",
    "reasonCode": "123",
    "tenantId": "e872a880-b14f-6d62-c312-cb40f22af465",
    "type": "user.action"
  }
}
```

Related

[Events User Create Event Learn about the User Create event. user webhookwebhook event](https://fusionauth.io/docs/events/reference/user/user-create.md)

[Events User Create Complete Event Learn about the User Create Complete event. user webhookwebhook event](https://fusionauth.io/docs/events/reference/user/user-create-complete.md)

[Events User Deactivate Event Learn about the User Deactivate event. user webhookwebhook event](https://fusionauth.io/docs/events/reference/user/user-deactivate.md)

[Events User Delete Event Learn about the User Delete event. user webhookwebhook event](https://fusionauth.io/docs/events/reference/user/user-delete.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 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 Two-factor Success Event](https://fusionauth.io/docs/events/reference/user/user-two-factor-success.md): Learn about the User Two-factor Success 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.