Which UI do you use?

Custom UI

Pre built UI

Manually generating a link

You can use our backend SDK to generate the email verification link as shown below:

NodeJS

Important

For other backend frameworks, you can follow our guide on how to spin up a separate server configured with the SuperTokens backend SDK to authenticate requests and issue session tokens.

GoLang

import EmailVerification from "supertokens-node/recipe/emailverification";

async function createEmailVerificationLink(userId: string, email: string) {
    try {
        // Create an email verification link for the user
        const linkResponse = await EmailVerification.createEmailVerificationLink("public", userId, email);

        if (linkResponse.status === "OK") {
            console.log(linkResponse.link);
        } else {
            // user's email is already verified
        }
    } catch (err) {
        console.error(err);
    }
}

Python

import (
    "github.com/supertokens/supertokens-golang/recipe/emailverification"
)

func main() {
    userID := "..."
    email := "..."

    // Create an email verification link for the user
    linkRes, err := emailverification.CreateEmailVerificationLink(userID, &email)
    if err != nil {
        // handle error
    }

    if linkRes.OK != nil {
        link := linkRes.link
        fmt.Println(link)

    } else {
        // user's email is already verified.
    }
}

Other Frameworks

Asyncio

from supertokens_python.recipe.emailverification.asyncio import create_email_verification_link
from supertokens_python.recipe.emailverification.interfaces import CreateEmailVerificationTokenOkResult

async def create_link(user_id: str, email: str):
    try:
        # Create an email verification link for the user
        link_res = await create_email_verification_link(user_id, email)

        if isinstance(token_res, CreateEmailVerificationTokenOkResult):
            link = link_res.link
            print(link)
        else:
            # user's email is already verified

Syncio

from supertokens_python.recipe.emailverification.syncio import create_email_verification_link
from supertokens_python.recipe.emailverification.interfaces import CreateEmailVerificationTokenOkResult

def create_link(user_id: str, email: str):
    try:
        # Create an email verification link for the user
        link_res = create_email_verification_link(user_id, email)

        if isinstance(token_res, CreateEmailVerificationTokenOkResult):
            link = link_res.link
            print(link)
        else:
            # user's email is already verified

Multi Tenancy

Notice that the first argument to the function call above is "public". This refers to the default tenant ID that is used in SuperTokens. It means that the generated email verification link can only be consumed by users belonging to the "public" tenant.

If you are using our multi tenancy feature, you can pass in the tenantId that contains this user, which you can fetch by getting the user object for this userId.

Finally, the generated link will use the configured websiteDomain from the appInfo object (in supertokens.init), however, you can change the domain of the generated link to match that of the tenant ID.