# Data migration

## Migrate from Auth0

 - [POST /resources/migrations/v1/auth0](https://developers.frontegg.com/ciam/api/identity/data-migration/userscontrollerv1_migrateuserfromauth0.md): Migrate users from Auth0 into your environment.

Provide the domain, clientId, secret, and tenantIdFieldName parameters in the request body. These values can be obtained from your Auth0 account (tenant) configuration.

## Migrate a single user

 - [POST /resources/migrations/v1/local](https://developers.frontegg.com/ciam/api/identity/data-migration/userscontrollerv1_migrateuserforvendor.md): Migrate a user into your environment.

Provide the required fields: user's email, tenantId, and metadata. You can also include additional properties such as the user's name, phone number, hashed password, and other optional attributes.

## Migrate users in bulk

 - [POST /resources/migrations/v1/local/bulk](https://developers.frontegg.com/ciam/api/identity/data-migration/userscontrollerv1_bulkmigrateuserforvendor.md): Migrate users in bulk into your environment.

Provide an array of users in the request body. Each user object must include the user's email and tenantId, which specifies the user's parent account. You can include additional fields as needed to store more information. If you need to store custom data, use the metadata property.

## Check status of bulk migration

 - [GET /resources/migrations/v1/local/bulk/status/{migrationId}](https://developers.frontegg.com/ciam/api/identity/data-migration/userscontrollerv1_checkbulkmigrationstatus.md): Retrieve the status of a pending or completed migration.

The response includes the migration's state, the number of migrated users, and any errors that occurred during the migration. The response payload is limited to 1,000 users.

## Migrate vendor users in bulk

 - [POST /resources/migrations/v2/local/bulk](https://developers.frontegg.com/ciam/api/identity/data-migration/userscontrollerv2_bulkmigrateuserforvendor.md): Migrate users in bulk to your environment. Provide an array of user objects, each containing email and tenantId. Use the metadata property to store custom information for each user.