Skip to content

Self registration

Self-registration allows new users to create an account within an organization without needing admin intervention. The flow can include steps to collect user details, verify identity, and set credentials before the account becomes active.

In the Flow Builder, you can create a self-registration journey in two ways:

  • Use a starter template – Load a ready made flow and customize it to your needs.

  • Build from scratch – Take full control by designing every step yourself.

Sample use case

Imagine a scenario where the self-registration form is simplified to only request essential user details. For added security, the user's email address must be verified using a Magic Link before the account becomes active.

The flow works as follows:

  1. The user enters their email and password.
  2. Asgardeo sends a Magic Link to the user's email address.
  3. The user clicks the link to verify their email address.
  4. Asgardeo creates the user's account.

This ensures that only users with a valid email address can self-register, helping to prevent fake or fraudulent sign-ups.

Final Flow

Build the flow

To build the sample use case, start with the Basic Details template and adjust it to use Magic Link verification.

Follow the steps below to configure this flow.

Step 1 – Navigate to self registration flow

To load the template,

  1. On the Asgardeo console, navigate to Flows.

  2. Click on the Self Registration card. The Basic Details template is loaded onto the canvas by default.

Step 1

Step 2 – Load the template

If the template isn't loaded automatically, click the + button next to the Basic Details template to load it onto the canvas.

Step 2

Step 2 – Tidy the form

Simplify the form to collect only the essentials for this registration flow.

  • In the Sign Up view, select and delete any fields that aren't required, keeping only Email and Password.

  • Remove the Email OTP view.

Step 3

Insert the Magic Link verification step between the initial sign-up and the successful completion.

  1. From the Steps panel, drag and drop a Magic Link View onto the canvas.
  2. Delete the existing connection from the Sign Up button to the green End node.
  3. Draw a new connection from the Sign Up button to the Magic Link View. The button's action will automatically update to Navigation.
  4. Draw a final connection from the Verify button (inside the Magic Link step) to the End node.

Step 4

Step 5 – Configure the flow completion

The End node determines what the user experiences upon successful registration. Customize the success message:

  1. Click on the green End node on the canvas.
  2. Edit the title (for example, "Registration Successful!") and the description text to customize the message shown to the user upon completion.

Set the completion properties:

  1. With the End node selected, click the gear icon (⚙️) to open the Flow Completion Properties.
  2. Configure the desired outcomes:
  3. Auto Login: Immediately logs the user in once the flow is completed, without requiring them to enter their credentials again.

Step 5

Step 6 – Enable the flow

Once the flow has been fully configured and is ready for users:

  1. Click Save Draft to save all changes.
  2. On the top-right corner of the Flow Builder, turn the toggle ON to publish the flow.

New users will now go through the simplified registration process with mandatory email verification using a Magic Link.

With these changes, new users will only provide the essentials Email and password and must verify their email via Magic Link before completing registration.

Note

When using a connection based sign up option (such as Google or Microsoft), configure the authorized redirect URL as: https://{is_host}/t/{tenant-domain}/accounts/register

Reference

This section provides details on the configuration options available in the Self Registration flow.

Flow completion properties

The Flow Completion Properties, configured on the End node, define the final actions that occur after a user successfully registers.

  • Verify the account on flow completion: Requires the user to confirm their account via an email link before they can sign in. This is useful for ensuring the user has access to the email they provided.

    Info

    This option won't be applied if the flow already includes a verification step (like Magic Link or Email/SMS OTP).

  • Activate the account on creation: Automatically activates the user account, allowing immediate access without a separate verification step.

  • Auto Login: If enabled, the user is automatically logged into their account immediately after successfully completing the registration flow.

  • Send a notification email on flow completion: When enabled, the user will receive an email confirming that their account has been successfully created.