Email

Email handler vals get their own email address that you can send email to. When Val Town receives that email, it triggers the val with the email as its first argument.

Tip

Vals can send email, too! Using the email function in the standard library

Type Signature

Email handlers receive an argument called Email that represents the email that was sent to the val. Here’s an example of an email handler:

Example

export function emailHandler(email: Email) {
  console.log("Email received!", email.from, email.subject, email.text);
}

The Email type has this shape:

interface Email {
  from: string;
  to: string[];
  subject: string | undefined;
  text: string | undefined;
  html: string | undefined;
}

Example

This val forwards any email it receives to me. Try it out by sending an email to stevekrouse.forwarder@valtown.email.

Limitations

Attachements not supported

Email handler vals do not support attachments. If they receive an email with an attachment, the attachment will be stripped. If this is something you want, please upvote the feature request to support attachments in email handler vals.