Import users in bulk
Manage users
This guide is designed to help you migrate from Auth0 to Kinde.
Switching between providers for any service can be daunting, and especially where user data is involved. We’ll walk you through the process or migrating, to take some of the pain away.
If you’ve got a lot of users (your export file is over 5MB) or are concerned about file size limits, you can contact us to ensure the import goes smoothly.
If you want to compare Kinde with Auth0, this page has some useful information.
A key point to note is that Kinde is OAuth2/OIDC compatible, issuing similar tokens to Auth0. You only need to update the token claims when you migrate.
If you haven’t already got a Kinde account, register for free here (no credit card required).
Auth0 doesn’t have an export option by default, so you’ll need to install an export extension.
You’ll now see it in your list of installed extensions. The first time you launch it, you’ll be asked to grant permission for the extension to access your Auth0 account.
File format guidelines:
Kinde supports migrating the following authentication methods from Auth0: Usernames, Email, Phone, Google, Apple, Microsoft, Facebook, GitHub, Twitch, Bitbucket. If you need to migrate another authentication type from Auth0 please get in touch with support.
Some Auth0 plans don’t allow password exports, or you might not want to wait 2 weeks for the json file. If this is the case, import the user data you’re able to, and Kinde will ask users to set a new password the next time they sign in.
Launch the extension by selecting Import / Export Extension.
Export your existing Auth0 users associated with database connections, select Export.
Select Add default fields and add the identities field to the import list. Identities data distinguishes the type of identity, e.g. username, phone, GitHub, Google, etc.
Change the Export Format to .json.
When you’re ready, click Export [X] Users. (X is the number of users you’re exporting).
Once the export is complete, select Download to get the file containing your user’s information. This is the main file you’ll need to migrate your users; the other file is the password hashes.
In Kinde, go to Users, then select Import users.
Select Auth0.
You’ll be presented with 2 options:
Follow the on-screen prompts to import the data.
If there are any errors with the import, you will be able to view them afterwards.
Most import errors can be fixed by editing the json file and then re-importing into Kinde.
Once the password hashes have been imported, your users will be able to sign in to Kinde with their existing password.
Social identities without an email can be imported, and are identified by the identity type. You can import users with multiple identities, these will be listed under the user’s profile.
Kinde does not send any notifications or invitations to users when they are added to Kinde via import. The idea is that your users have a seamless experience that feels (almost) like it always has in your app.
Similarly, if you add users via API, Kinde does not send an email or notification to the user.
If you’ve made changes to their sign in experience — for example adding multi-factor authentication — then consider contacting your users to let them know their sign in experience will be changed.
Importing all your existing users and passwords following the above process should mean that your users won’t notice anything when they next sign in. This is the optimal experience. However:
During and following the migration, we recommend checking for these issues.
When you import passwords, Kinde does not check for password strength. You’ll want to enforce your own password policies for users.
If you have important objects that need to be migrated, such as organizations or roles outside the basic user information, you can import them, or add them via the Kinde management API.
Before you migrate, however, be aware that the functionality of these objects may differ between Auth0 and Kinde. Here’s some similarities and differences to note:
We’ve tried to make onboarding to Kinde as easy as possible, because we know it’s a pain to break up with your old provider. We’re here to help and can assist with your migration.
Contact us via: Slack, Discord, Email, Chat
Book a call for: