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:

Parameter	Description
users	File in JSON format that contains the users to import.
connection_id	ID of the connection to which users will be inserted. You can retrieve the ID using the GET /api/v2/connections endpoint.
upsert	Boolean value; false by default. When set to false, pre-existing users that match on email address will fail. When set to true, pre-existing users that match on email address will be updated, but only with upsertable attributes. For a list of user profile fields that can be upserted during import, see User Profile Attributes.
external_id	Optional user-defined string that can be used to correlate multiple jobs. Returned as part of the job status response.
send_completion_email	Boolean value; true by default. When set to true, sends a completion email to all tenant owners when the import job is finished. If you do not want emails sent, you must explicitly set this parameter to false.

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

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.

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