The ZITADEL API has different possibilities to create users. This can be used, if you are building your own registration page.
With Username and Password
If you are collecting all the user information and a password, you can directly create the user with the password.
password_change_required flag you can choose if the user has to change the password on the first login or not.
This might make sense if an administrator created the user.
You can directly ask for a link to create the passwordless registration for the user.
Fill the user data and set the attribute
request_passwordless_registration to true.
You will get a link for the registration and an expiration time in the response.
If you add
requestPlatformType as query parameter to the link you can define what type the platform should be.
- platform: Device itself e.g. FaceID, Fingerprint etc.
- crossPlatform A hardware token e.g SoloKey
- unspecified The user is free to choose
If nothing is requested, the type will not be restricted and all possibilities of the device will be taken into account.
Add passwordless to existing user
If you already have a user in ZITADEL, it is possible to add passworless later.
Send the user_id in the request and you will get a link and an expiration as response. You can then customize the link the same as described above in the creation process.
The second possibility is to send the link directly to the user per email. Use the following request in that case: