Import to Zoho Directory - Auth0 | Getting Started Guides - Zoho Directory

Import users from Auth0 to Zoho Directory

If you are currently using Auth0 as your cloud directory service to store your organization data, you can easily import your users to Zoho Directory.

Export users from Auth0

  1. Sign in to Auth0 as administrator.
  2. Go to Extensions.
  3. Scroll down and select the User Import/Export extension.
  4. Click Install. Once installed, you can view the extension in the Installed Extensions tab.
  5. Click on the User Import/Export extension.
  6. Click Accept to authorize the extension.
  7. Click Export.
  8. In the User Fields and Column Name fields, add the fields one by one, by referring to the Zoho Directory CSV file template. To get the template:
    1. Sign in to Zoho Directory .
    2. Go to Users. Click  icon in the top-right corner.
    3. Click Import.
    4. Click Download Sample File. A CSV file containing the sample data will be downloaded.
      The mandatory field is Email. Add the email address field as the below format:
      User Fields
      Column Name
      email
      Email
      Other fields are optional and can be included if you have created any such fields for the users in the user_metadata or app_metadata in the User details page. For example, if you have created fields for the users' "department", "group" and "manager" in the user_metadata, then add the fields in the following format:
      User Fields
      Column Name
      user_metadata.department
      Department
      user_metadata.group
      Group
  9. Under SETTINGS, select Tab Separated Value file (*.csv) for Export Format field.
  10. Click Export User. Once the export is done, click Download. A compressed file with .gz format will be downloaded.
  11. Extract the file to obtain the CSV file containing the user details.

Import users to Zoho Directory

  1. Sign in to Zoho Directory , then click Admin Panel in the left menu.
  2. Go to Users. Click  icon in the top right corner.
  3. Click Import.
  4. Click Choose File, then browse and select the CSV file that you have extracted from the zipped file downloaded from Auth0.
  5. In the Character Encoding field, choose UTF-8 (Unicode).
    Import CSV file

    Character encoding

  6. Click Next. Check and map the fields present in the imported CSV by doing the following:
    1. To check which fields are already mapped, click Mapped. Check if the mapped details are correct, else edit them.
      Map fields
    2. To check which fields are not mapped, click Unmapped. Map the fields in the CSV file to their appropriate Zoho Directory field.
      Map fields
    3. If there are multiple email addresses, map them all to the Email Address field using the  icon. For the Password field, click Set Password to set a common one-time password for all the imported users, then enter the password. The users will be prompted to change this password when they first sign in.
      Map multiple email addresses
      Set password
  7. Click Next. The process may take a while. Meanwhile, you can navigate to different tabs or pages if needed. Once the import is done, the imported users will now be added to Zoho Directory.
Once you have successfully imported the users in Zoho Directory, you can view all the imported users in the Users tab. You can now manage users, edit their details, and assign them apps and admin privileges in Zoho Directory. To learn more about how you can manage users in Zoho Directory, check out our detailed admin guide.