Import users in bulk

Link to this section

You can import users in bulk, from CSV or from other files provided by your previous  authentication service, such as Auth0.

Before you import

Link to this section
  • User details need to be in CSV format
  • Passwords can be in either CSV or JSON format
  • File size limit 1MB (around 10,000 users)
  • Enable password authentication before importing passwords
  • Create organizations in Kinde - only if you use this function to support multi-tenancy (for example, in a B2B structure) or if you manage separate user groups this way.

Importing users from MS Azure AD

Link to this section

Set up the Azure AD connection in Kinde before you import your users.

Then when you import user details from MS Azure AD, Kinde will match them to the relevant connection based on their email address.

When exporting data from another auth system or your own system, make sure the CSV file you export is formatted in rows with these column headings.

  • *email - this is a required field to import to Kinde
  • first_name and last_name
  • id - unique to the auth provider and helps us match records as they are imported.
  • email_verified - account verification status: TRUE or FALSE
  • hashed_password - encrypted using an algorithm such as bcrypt, crypt or md5
  • hashing_method - tells us which algorithm was used to encrypt the password
  • salt - extra characters added to passwords to make them stronger
  • salt_position - position of salt in password string. Prefix (before) or suffix (after)
  • external_organization_id - the ID of the organizations you want the user to be imported into (if applicable). If the user belongs to more than one organization, use a comma separated list.

See the Switch to Kinde for user authentication guide for full import preparation details.

*Note that only the email field is mandatory, but the more data that you bring in, the easier we can set up your users in Kinde.

Auth0-specific import options

Link to this section

When you export user details from Auth0 make sure you export default fields, as well as these fields in the CSV: app_metadata, blocked, user_metadata, username, last_ip, last_login, logins_count, multifactor, name, phone_number, phone_verified.

When importing users from Auth0 source files, you have three options:

  1. Import users and passwords - if you have the user (CSV) and password (JSON) files.
  2. Import users only - if you want to import users now and passwords later. You can also use this method if you want to allow users to reset their password or sign in another way.
  3. Import passwords only - only choose this if you have already imported users.

To import users

Link to this section
  1. In Kinde, go to Users, then select Import users.

  2. Select the option for your situation:

    • Custom CSV
    • From Auth0 (choose this for Azure AD users)
  3. Follow the on-screen prompts to import the data.

  4. If there are any errors with the import, you will be able to view them afterwards.

  5. Most import errors can be fixed by editing the CSV file and then re-importing into Kinde. Any records that have already been imported and have not been edited, will be ignored.

Impact for end users

Link to this section
  • Importing all users and passwords should mean that your users won’t notice anything when they next sign in.
  • If a user changes their password after the user export and while the migration is in progress, they will be prompted to reset their password on the next sign in.
  • If you have set up a new authentication method as part of the user migration (for instance, going passwordless) your users will be prompted to use the new method on sign in.

Talk to us

If you can’t find what you’re looking for in our help center — email our team

Contact us
Talk to us