# User Bulk Create Event

Learn about the User Bulk Create event.

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

## User Bulk Create

This event is generated when multiple users are created via the [User Import API](https://fusionauth.io/docs/apis/users/import.md). The JSON includes each of the Users that were created.

Event type

user.bulk.create

### Event Scope

Prior to version `1.37.0` this was a tenant-scoped event. This event will be sent to all tenants that are listening, but will contain a **tenantId** to allow for filtering.

In version `1.37.0` and later this is also 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 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/extend/events-and-webhooks/writing-a-webhook.md#calling-fusionauth-apis-in-webhooks)

### Event Body

`event.createInstant`

*   Long

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

`event.id`

*   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`

*   Object
*   Available since 1.30.0

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

`event.info.deviceDescription`

*   String
*   Available since 1.30.0

The description of the device associated with the event.

`event.info.deviceName`

*   String
*   Available since 1.30.0

The device name associated with the event.

`event.info.deviceType`

*   String
*   Available since 1.30.0

The type of device associated with the event.

`event.info.ipAddress`

*   String
*   Available since 1.27.0

The source IP address of the event.

`event.info.location.city`

*   String
*   Available since 1.30.0

The city where the event originated.

**Note:** To use event location data, you'll need an Enterprise plan.

`event.info.location.country`

*   String
*   Available since 1.30.0

The country where the event originated.

**Note:** To use event location data, you'll need an Enterprise plan.

`event.info.location.latitude`

*   Double
*   Available since 1.30.0

The latitude where the event originated.

**Note:** To use event location data, you'll need an Enterprise plan.

`event.info.location.longitude`

*   Double
*   Available since 1.30.0

The longitude where the event originated.

**Note:** To use event location data, you'll need an Enterprise plan.

`event.info.location.region`

*   String
*   Available since 1.30.0

The geographic location where the event originated.

**Note:** To use event location data, you'll need an Enterprise plan.

`event.info.location.zipcode`

*   String
*   Available since 1.30.0

The zip code where the event originated.

**Note:** To use event location data, you'll need an Enterprise plan.

`event.info.os`

*   String
*   Available since 1.30.0

The operating system associated with the event.

`event.info.userAgent`

*   String
*   Available since 1.30.0

The user agent associated with the event.

`event.tenantId`

*   UUID
*   Available since 1.8.0

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

`event.type`

*   String

The event type, this value will always be `user.bulk.create`.

`event.users`

*   Array<Object>

The users that have been created. See the [Users API](https://fusionauth.io/docs/apis/users.md) for property definitions and example JSON.

*Example Event JSON*

```json
{
  "event": {
    "createInstant": 1505762615056,
    "id": "e502168a-b469-45d9-a079-fd45f83e0406",
    "tenantId": "e872a880-b14f-6d62-c312-cb40f22af465",
    "type": "user.bulk.create",
    "users": [
      {
        "active": true,
        "connectorId": "e3306678-a53a-4964-9040-1c96f36dda72",
        "email": "example@fusionauth.io",
        "id": "00000000-0000-0001-0000-000000000000",
        "lastLoginInstant": 1471786483322,
        "passwordChangeRequired": false,
        "passwordLastUpdateInstant": 1471786483322,
        "registrations": [
          {
            "applicationId": "10000000-0000-0002-0000-000000000001",
            "id": "00000000-0000-0002-0000-000000000000",
            "insertInstant": 1446064706250,
            "lastLoginInstant": 1456064601291,
            "roles": [
              "user"
            ],
            "usernameStatus": "ACTIVE"
          }
        ],
        "tenantId": "f24aca2b-ce4a-4dad-951a-c9d690e71415",
        "twoFactorEnabled": false,
        "usernameStatus": "ACTIVE",
        "verified": true
      }
    ]
  }
}
```
---

## Other pages in User

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

- [User Login Failed Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/login/user-login-failed.md): Learn about the User Login Failed event.
- [User Login Id Duplicate Create Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/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/extend/events-and-webhooks/events/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/extend/events-and-webhooks/events/user/login/user-login-new-device.md): Learn about the User Login New Device event.
- [User Login Success Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/login/user-login-success.md): Learn about the User Login Success event.
- [User Login Suspicious Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/login/user-login-suspicious.md): Learn about the User Login Suspicious event.
- [User Password Breach Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/password/user-password-breach.md): Learn about the User Password Breach event.
- [User Password Reset Send Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/password/user-password-reset-send.md): Learn about the User Password Reset Send event.
- [User Password Reset Start Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/password/user-password-reset-start.md): Learn about the User Password Reset Start event.
- [User Password Reset Success Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/password/user-password-reset-success.md): Learn about the User Password Reset Success event.
- [User Password Update Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/password/user-password-update.md): Learn about the User Password Update event.
- [User Registration Create Complete Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/registration/user-registration-create-complete.md): Learn about the User Registration Create Complete event.
- [User Registration Create Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/registration/user-registration-create.md): Learn about the User Registration Create event.
- [User Registration Delete Complete Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/registration/user-registration-delete-complete.md): Learn about the User Registration Delete Complete event.
- [User Registration Delete Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/registration/user-registration-delete.md): Learn about the User Registration Delete event.
- [User Registration Update Complete Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/registration/user-registration-update-complete.md): Learn about the User Registration Update Complete event.
- [User Registration Update Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/registration/user-registration-update.md): Learn about the User Registration Update event.
- [User Registration Verified Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/registration/user-registration-verified.md): Learn about the User Registration Verified event.
- [User Action Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-actions.md): Learn about the User Action event.
- [User Create Complete Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-create-complete.md): Learn about the User Create Complete event.
- [User Create Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-create.md): Learn about the User Create event.
- [User Deactivate Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-deactivate.md): Learn about the User Deactivate event.
- [User Delete Complete Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-delete-complete.md): Learn about the User Delete Complete event.
- [User Delete Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-delete.md): Learn about the User Delete event.
- [User Email Update Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-email-update.md): Learn about the User Email Update event.
- [User Email Verified Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-email-verified.md): Learn about the User Email Verified event.
- [User Identity Provider Link Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-identity-provider-link.md): Learn about the User Identity Provider Link event.
- [User Identity Provider Unlink Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-identity-provider-unlink.md): Learn about the User Identity Provider Unlink event.
- [User Identity Verified Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-identity-verified.md): Learn about the User Identity Verified event.
- [User Reactivate Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-reactivate.md): Learn about the User Reactivate event.
- [User Two-factor Challenge Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-two-factor-challenge.md): Learn about the User Two-factor Challenge event.
- [User Two-factor Failed Attempt Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/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/extend/events-and-webhooks/events/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/extend/events-and-webhooks/events/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/extend/events-and-webhooks/events/user/user-two-factor-success.md): Learn about the User Two-factor Success event.
- [User Update Complete Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-update-complete.md): Learn about the User Update Complete event.
- [User Update Event](https://fusionauth.io/docs/extend/events-and-webhooks/events/user/user-update.md): Learn about the User Update event.