Change Email: Wristband-Hosted UI

Wristband Identity Provider: Password Login

By default, the Action Link in the Email Change Confirmation email directs users to a Wristband-hosted Email Change Confirmation Page.

Workflow Steps:

1. The user clicks on the Action Link in the Email Change Confirmation email that was sent to their inbox.
2. The user is redirected to the Wristband-hosted Email Change Confirmation Page.
3. The user submits their password.
4. Wristband calls the Wristband Confirm New Email For Password Auth Flow API, passing along the Email Authorization Code.
5. A message is displayed to the user indicating that verification succeeded.

At this point, the workflow is complete, and the user can exit the page.

Wristband Identity Provider: Magic Link Login (Passwordless)

By default, the Action Link in the Passwordless Email Change Confirmation email directs users to a Wristband-hosted Passwordless Email Change Confirmation Page.

Workflow Steps:

1. The user clicks on the Action Link in the Email Change Confirmation email that was sent to their inbox.
2. The user is redirected to the Wristband-hosted Email Change Confirmation Page.
3. The user clicks the "Continue" button.
4. Wristband calls the Wristband Confirm New Email For Passwordless Email Auth Flow API, passing along the Email Authorization Code.
5. During API execution, a Passwordless Email Change Confirmation email is sent to the user's current email address.
6. The user clicks on the Action Link in the Passwordless Email Change Confirmation email that was sent to their inbox.
7. The user is redirected to the Wristband-hosted Passwordless Email Change Confirmation Page.
8. Wristband calls the Wristband Confirm Current Email For Passwordless Email Auth Flow API, passing along the Email Authorization Code.
9. A message is displayed to the user indicating that verification succeeded.

At this point, the workflow is complete, and the user can exit the page.

External Identity Provider Change Email

By default, completing authentication with the external IDP directs users to a Wristband-hosted External IDP Email Change Confirmation Page.

Workflow Steps:

1. The user clicks on the Action Link in the Email Change Confirmation email that was sent to their inbox.
2. The user is redirected to the Wristband-hosted Email Change Confirmation Page.
3. The user clicks the "Authenticate" button, which triggers a call to the Wristband Authorize External IDP User for Change Email Endpoint.
4. Wristband redirects the user to the identity provider's account login page.
5. The user submits their credentials.
6. The identity provider redirects the user to the Wristband External IDP Callback Endpoint (which can be found in the Identity Providers section of the Wristband dashboard for your given IDP), where Wristband creates an External IDP Authorization Code required for completing authentication.
7. Wristband redirects the user to the Wristband-hosted External IDP Email Change Confirmation Page along with an External IDP Authorization Code that will be used for verification.
8. Wristband calls the Wristband Confirm New Email For External IDP Auth Flow API, passing along the External IDP Authorization Code.
9. A message is displayed to the user indicating that verification succeeded.

At this point, the workflow is complete, and the user can exit the page.