Enchanted Link with Flows

This guide will walk you through integrating enchanted link based authentication into your Descope Flows. Enchanted Links allows your users to authenticate using their existing accounts with popular social platforms like Google, Facebook, and GitHub.

Enchanted Link starts the session in the existing tab after polling completes. If you wish to start the user session in a new tab, check out Magic Link instead.

Flow Actions

When using Enchanted Link, you have the standard actions for most authentication methods available.

  • Sign Up / Enchanted Link - Signs the user up, but will not work if user already exists
  • Sign Up or In / Enchanted Link - Signs the user in, and if user doesn't exist it will automatically sign them up
  • Sign In / Enchanted Link - Signs the user in, but if the user doesn't exist it will fail.
  • Update User / Enchanted Link - Will merge OAuth identity to an existing user

To learn more about Actions in general, you can refer to our guide on them.

Most of these actions are pretty simple, and you can drop them in your application like any other Action.

This is an example of using the Sign Up or In action in a flow:

sign-up-or-in-flow-action

Flow Screens

When using Enchanted Link, there will typically be a screen present for polling, with a horizontal scrolling sidebar, as part of the actions listed above. All you need to do to use enchanted links, is to connect the actions to a screen that has a Custom Login ID, Email, or Phone input.

enchanted-link-polling

Error Handling

Error handling is handled like any other action. You can refer to our Flow Error Handling guide for more details.

Was this helpful?

On this page