If you already have a user database, you can use the POST /api/v2/jobs/users/post_users_imports endpoint to populate a database connection with this information. The user data should first be exported in JSON format. You can then import that file using our API. To see database file schema and examples, visit Bulk Import Database Schema and Example.

For a list of user profile fields that can be inserted and updated during import, see User Profile Attributes.

Using the bulk import endpoints, you can:

1. Request a bulk import of users to a connection and receive a response.
2. Query job's status.
3. Check for details on any failed entries in your job.

Before you launch the import users job, you must:

• Configure a database connection to which the users will be imported and enable it for at least one application.

The Create Job to Import Users endpoint requires that your POST request encoded as type multipart/form-data.

Create a request that contains the following parameters:

If the request works, you will receive a response similar to the following:

{
    "status":"pending",
    "type":"users_import",
    "id":"job_abcdef1234567890",
    "connection":"abcd",
    "external_id":"contoso"
}

The returned entity represents the import job.

Once the job finishes, the owner(s) of the Auth0 tenant that the job is being run on will get an email notifying them about whether it failed or succeeded (if send_completion_email was set to true). A notification email for a job that failed might notify the owner(s) that it failed to parse the users file JSON when importing users.

You can query a job's status using the Get a Job endpoint. If the job is complete, the job status response will also show summary totals of successful/failed/inserted/updated records. If there is an error in the job, it will return as failed; however, note that invalid user information, such as an invalid email, will not make the entire job fail.

Additionally, the job status is added to Tenant Logs, which allows for a custom WebHook to be triggered using the WebHook Logs Extension.

All user import jobs timeout after two (2) hours. If your job does not complete within this time frame, it is marked as failed.

Furthermore, all of your job-related data is automatically deleted after 24 hours and cannot be accessed afterward. As such, we strongly recommend storing the job results using the storage mechanism of your choice.

You can query and retrieve details on failed entries via the API using the Get Failed Job Error Details endpoint.

• User Migration Overview
• Configure Automatic Migration from Your Database
• User Import/Export Extension
• Bulk Import Database Schema and Example
• User Migration Scenarios