Skip to main content

If you are using our backend SDK that is lesser than the following versions, please visit the older documentation link here.

Handle Event Hook

This function is called for various user actions. It can be used for logging, analytics or any side effect purposes (these are essentially fire and forget events).

import Passwordless from "supertokens-auth-react/recipe/passwordless";
import ThirdParty from "supertokens-auth-react/recipe/thirdparty";

Passwordless.init({
    contactMethod: "EMAIL", // This example will work with any contactMethod
    onHandleEvent: (context) => {
        if (context.action === "PASSWORDLESS_RESTART_FLOW") {
            // TODO:
        } else if (context.action === "PASSWORDLESS_CODE_SENT") {
            // TODO:
        } else if (context.action === "SUCCESS") {
            if (context.createdNewSession) {
                let user = context.user;
                if (context.isNewRecipeUser && context.user.loginMethods.length === 1) {
                    // sign up success
                } else {
                    // sign in success
                }
            } else {
                // during second factor authentication
            }
        }
    },
})

ThirdParty.init({
    onHandleEvent: (context) => {
        if (context.action === "SUCCESS") {
            if (context.createdNewSession) {
                let user = context.user;
                if (context.isNewRecipeUser && context.user.loginMethods.length === 1) {
                    // sign up success
                } else {
                    // sign in success
                }
            } else {
                // during linking a social account to an existing account
            }
        }
    },
})
info

Also checkout the session recipe hand event hook.

Looking for older versions of the documentation?
Which UI do you use?
Custom UI
Pre built UI