User Activation: Self-Hosted UI

If you intend to self-host the User Activation Page, you can configure Wristband to reference the URL where your page is located. Wristband will then direct users to your page wherever it needs to be presented during the User Activation flow.

Configuration

Email Policies

Under Email Policies in the Application View of the Wristband Dashboard, set the Action Link URL for the User Activation email template to the location of your self-hosted User Activation Page. Wristband sends this URL in the activation email when a user needs to activate their account. This can also be overridden at the tenant level under Email Policies in the Tenant View.

User Activation Workflow

At a high level:

1. The user clicks on the Action Link in the activation email that was sent to their inbox.
2. The user is redirected to your application's self-hosted User Activation Page along with the Email Authorization Code query parameter.
3. Your application calls the Wristband Activate User API, passing along the Email Authorization Code. The user's status is changed from PENDING_USER_ACTIVATION to ACTIVE, and their email is marked as verified.
4. Your application then redirects the user to the Wristband Create Auth Session for Activated User API to create a Wristband Authentication Session for the user. The redirect URL is returned in the response from the prior step as well as an Auth Session Code required to successfully create the session.
5. Wristband redirects the user to the Login Endpoint implemented by your application.

From here, the user would go through the Authorization Code Flow to log in and gain entry to the application. Because Wristband already created an Authentication Session for the user during signup, the user gains immediate entry into the application without having to re-enter their credentials.