Change email content
To change the content of the default email templates, you can override the getContent
function in the emailDelivery
object. It allows you to return an object that has the following properties:
body
: This is the email's body. This can be HTML or just text as well.isHtml
: If the body is HTML, then this should betrue
.subject
: This is the subject of the email to send.toEmail
: The email will be sent to this email.
Other information like which email ID to send from is specified in the smtpSettings
object.
- NodeJS
- GoLang
- Python
import supertokens from "supertokens-node";import Passwordless from "supertokens-node/recipe/passwordless";import Session from "supertokens-node/recipe/session";import { SMTPService } from "supertokens-node/recipe/passwordless/emaildelivery";
supertokens.init({ appInfo: { apiDomain: "...", appName: "...", websiteDomain: "..." }, recipeList: [ Passwordless.init({ emailDelivery: { service: new SMTPService({ smtpSettings: { /*...*/ }, override: (originalImplementation) => { return { ...originalImplementation, getContent: async function ({ codeLifetime, // amount of time the code is alive for (in MS) email, urlWithLinkCode, // magic link userInputCode, // OTP }) { // send some custom email content return { body: "EMAIL BODY", isHtml: true, subject: "Some subject", toEmail: email }
// You can even call the original implementation and // modify its content: /* let originalContent = await originalImplementation.getContent(input) originalContent.subject = "My custom subject"; return originalContent; */ } } } }) } }), Session.init() ]});
import ( "fmt"
"github.com/supertokens/supertokens-golang/ingredients/emaildelivery" "github.com/supertokens/supertokens-golang/recipe/passwordless" "github.com/supertokens/supertokens-golang/recipe/passwordless/plessmodels" "github.com/supertokens/supertokens-golang/supertokens")
func main() {
supertokens.Init(supertokens.TypeInput{ RecipeList: []supertokens.Recipe{ passwordless.Init(plessmodels.TypeInput{ EmailDelivery: &emaildelivery.TypeInput{ Service: passwordless.MakeSMTPService(emaildelivery.SMTPServiceConfig{ Settings: emaildelivery.SMTPSettings{ /* ... */ },
Override: func(originalImplementation emaildelivery.SMTPInterface) emaildelivery.SMTPInterface {
// originalGetContent := *originalImplementation.GetContent
(*originalImplementation.GetContent) = func(input emaildelivery.EmailType, userContext supertokens.UserContext) (emaildelivery.EmailContent, error) { // amount of time the code is alive for (in MS) codeLifetime := input.PasswordlessLogin.CodeLifetime email := input.PasswordlessLogin.Email
// magic link urlWithLinkCode := input.PasswordlessLogin.UrlWithLinkCode
// OTP userInputCode := input.PasswordlessLogin.UserInputCode fmt.Println(codeLifetime) fmt.Println(email) fmt.Println(urlWithLinkCode) fmt.Println(userInputCode)
// send some custom email content return emaildelivery.EmailContent{ Body: "EMAIL BODY", IsHtml: true, Subject: "Some subject", ToEmail: email, }, nil
// you can even call the original implementation and modify that
/* originalContent, err := originalGetContent(input, userContext) if err != nil { return emaildelivery.EmailContent{}, err } originalContent.Subject = "My custom subject" return originalContent, nil */
}
return originalImplementation },
}), }, }), }, })}
from supertokens_python import init, InputAppInfofrom supertokens_python.recipe import passwordlessfrom supertokens_python.ingredients.emaildelivery.types import EmailDeliveryConfig, SMTPSettings, EmailContentfrom supertokens_python.recipe.passwordless.types import SMTPOverrideInput, EmailTemplateVarsfrom typing import Dict, Any
def custom_smtp_content_override(original_implementation: SMTPOverrideInput) -> SMTPOverrideInput:
# original_get_content = original_implementation.get_content
async def get_content(template_vars: EmailTemplateVars, user_context: Dict[str, Any]) -> EmailContent: # amount of time the code is alive for (in MS) _ = template_vars.code_life_time email = template_vars.email __ = template_vars.url_with_link_code # magic link ___ = template_vars.user_input_code # OTP
# send some custom email content return EmailContent(body="EMAIL BODY", subject="Some subject", is_html=True, to_email=email)
# you can even call the original implementation and modify that
# original_content = await original_get_content(template_vars, user_context) # original_content.subject = "My custom subject" # return original_content
original_implementation.get_content = get_content return original_implementation
init( app_info=InputAppInfo( api_domain="...", app_name="...", website_domain="..."), framework='...', recipe_list=[ passwordless.init( email_delivery=EmailDeliveryConfig( service=passwordless.SMTPService( smtp_settings=SMTPSettings(...), override=custom_smtp_content_override ) ) ) ])