Skip to main content

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.
I