User Activation Workflow

To ensure the legitimacy of users and grant them access to your application, they must have an ACTIVE status. This status also enables you to track and identify the users who are actively engaged with your application. The User Activation Workflow provides an explicit way for a user to be activated. It involves Wristband sending a transactional email to the user's email address that requires activation. This email includes an Action Link that, when clicked, directs the user to a page with a unique Email Authorization Code. This one-time code is utilized for finalizing the activation through the Wristband Activate User API.

These are the workflows where a user may trigger the User Activation Workflow, assuming the appropriate Workflow Policy is configured:

  • Wristband IDP Signup
  • External IDP Signup if the synced External IDP Userinfo contains an email address that is not verified

Retrying/Recovering User Activation

When a user performs a Signup Workflow with the User Activation Workflow Policy configured, they must complete activation within the allotted expiration time set in the User Activation Email Policy. The user will reside in either the PENDING_INVITE_ACTIVATION or PENDING_SIGNUP_ACTIVATION status (depending on the workflow) until they complete the activation. If they don't complete activation within the expiration window, they can still receive another User Activation email to prevent them from getting "stuck." The user can fill out the Signup Form again to achieve this. As long as the user provides the same email address as the initial Signup attempt (as well as the same tenant domain name if it's a multi-tenant application), Wristband will send a fresh User Activation email to them without re-provisioning the user or their tenant.

You can also send activation emails directly to your application's users from the Wristband Dashboard, accessible through the Edit User Page.