lettre/website/content/creating-messages/email.md

Creating messages

This section explains how to create emails.

Simple example

The email part builds email messages. For now, it does not support attachments. An email is built using an EmailBuilder. The simplest email could be:

extern crate lettre_email;

use lettre_email::Email;

fn main() {
    // Create an email
    let email = Email::builder()
        // Addresses can be specified by the tuple (email, alias)
        .to(("user@example.org", "Firstname Lastname"))
        // ... or by an address only
        .from("user@example.com")
        .subject("Hi, Hello world")
        .alternative("<h2>Hi, Hello world.</h2>", "Hi, Hello world.")
        .build();
    
    assert!(email.is_ok());
}

When the build method is called, the EmailBuilder will add the missing headers (like Message-ID or Date) and check for missing necessary ones (like From or To). It will then generate an Email that can be sent.

The text() method will create a plain text email, while the html() method will create an HTML email. You can use the alternative() method to provide both versions, using plain text as fallback for the HTML version.