Import users

Migrating from another authentication provider? Import your existing users directly through the Hanko Cloud Console.
All user IDs must be in UUID format for successful import.
1

Access the Users section

Navigate to Hanko Cloud, select your project, and click ‘Users’ in the left sidebar.
2

Start the import process

click import
3

Upload and import your user data

upload user file
Structure your import file as a JSON array of user objects. Each object represents one user with their details. Reference the official schema for proper data formatting.
users.json
[
  {
    "user_id": "d0f8fe0f-9fd0-4974-a927-63aaa54be787",
    "emails": [
      {
        "address": "arvidwalsh@schumm.biz",
        "is_primary": true,
        "is_verified": true
      }
    ],
    "created_at": "2023-07-11T13:41:50.290862Z",
    "updated_at": "2023-07-11T13:41:50.290862Z"
  },
  {
    "user_id": "c8d1628d-9258-4686-9063-1334fc7b0a7a",
    "emails": [
      {
        "address": "horaciosteuber@emmerich.io",
        "is_primary": true,
        "is_verified": true
      }
    ],
    "created_at": "2023-07-11T13:41:50.290872Z",
    "updated_at": "2023-07-11T13:41:50.290872Z"
  }
]

Export users

Export your user data using the Hanko Admin API to retrieve comprehensive user information. A dedicated export feature matching the import functionality will be added to Hanko Cloud in the near future.
The Hanko Admin API is available with paid plans.