Struct Email 

pub struct Email {

    pub from: Option<Address>,
    pub to: Vec<Address>,
    pub cc: Vec<Address>,
    pub bcc: Vec<Address>,
    pub reply_to: Vec<Address>,
    pub subject: String,
    pub text_body: Option<String>,
    pub html_body: Option<String>,
    pub attachments: Vec<Attachment>,
    pub headers: HashMap<String, String>,
    pub assigns: HashMap<String, Value>,
    pub private: HashMap<String, Value>,
    pub provider_options: HashMap<String, Value>,
}

An email message.

Use the builder pattern to construct emails:

use missive::Email;

let email = Email::new()
    .from("sender@example.com")
    .to("recipient@example.com")
    .subject("Hello!")
    .text_body("Plain text content")
    .html_body("<h1>HTML content</h1>");

Fields

• from, to, cc, bcc - Addresses
• reply_to - Reply-to addresses (supports multiple)
• subject, text_body, html_body - Content
• attachments - File attachments
• headers - Custom email headers
• assigns - Template variables (for use with templating systems)
• private - Private storage for libraries/frameworks
• provider_options - Provider-specific options (tags, templates, etc.)

Fields

from: Option<Address>

Sender address

to: Vec<Address>

Primary recipients

cc: Vec<Address>

Carbon copy recipients

bcc: Vec<Address>

Blind carbon copy recipients

reply_to: Vec<Address>

Reply-to addresses (supports multiple)

subject: String

Email subject line

text_body: Option<String>

Plain text body

html_body: Option<String>

HTML body

attachments: Vec<Attachment>

File attachments

headers: HashMap<String, String>

Custom email headers

assigns: HashMap<String, Value>

Template variables for use with templating systems.

private: HashMap<String, Value>

Private storage for libraries/frameworks (e.g., template paths, metadata).

provider_options: HashMap<String, Value>

Provider-specific options (e.g., tracking, tags, templates)

Implementations

impl Email

pub fn new() -> Self

Create a new empty email.

pub fn from(self, addr: impl ToAddress) -> Self

Set the sender address.

Accepts anything that implements ToAddress:

• "email@example.com" - just email
• ("Name", "email@example.com") - name and email
• Custom types that implement ToAddress

pub fn to(self, addr: impl ToAddress) -> Self

Add a recipient.

Can be called multiple times to add multiple recipients. Accepts anything that implements ToAddress.

pub fn put_to(self, addrs: Vec<Address>) -> Self

Replace all recipients.

pub fn cc(self, addr: impl ToAddress) -> Self

Add a CC recipient. Accepts anything that implements ToAddress.

pub fn put_cc(self, addrs: Vec<Address>) -> Self

Replace all CC recipients.

pub fn bcc(self, addr: impl ToAddress) -> Self

Add a BCC recipient. Accepts anything that implements ToAddress.

pub fn put_bcc(self, addrs: Vec<Address>) -> Self

Replace all BCC recipients.

pub fn reply_to(self, addr: impl ToAddress) -> Self

Add a reply-to address.

Can be called multiple times to add multiple reply-to addresses. Accepts anything that implements ToAddress.

pub fn put_reply_to(self, addrs: Vec<Address>) -> Self

Replace all reply-to addresses.

pub fn subject(self, subject: impl Into<String>) -> Self

Set the subject line.

pub fn text_body(self, body: impl Into<String>) -> Self

Set the plain text body.

pub fn html_body(self, body: impl Into<String>) -> Self

Set the HTML body.

pub fn attachment(self, attachment: Attachment) -> Self

Add an attachment.

pub fn header(self, name: impl Into<String>, value: impl Into<String>) -> Self

Add a custom header.

pub fn provider_option( self, key: impl Into<String>, value: impl Into<Value>, ) -> Self

Set a provider-specific option.

These are passed to the adapter for provider-specific features (e.g., SendGrid categories, Postmark tags, Resend templates).

Example

Email::new()
    .provider_option("template_id", "welcome-email")
    .provider_option("tags", vec!["signup", "welcome"])

pub fn assign(self, key: impl Into<String>, value: impl Into<Value>) -> Self

Store a template variable for use with templating systems.

Example

Email::new()
    .assign("username", "alice")
    .assign("action_url", "https://example.com/verify")

pub fn put_private( self, key: impl Into<String>, value: impl Into<Value>, ) -> Self

Store a private value for frameworks/libraries.

Reserved for framework use (e.g., template paths, metadata).

Example

Email::new()
    .put_private("template_path", "emails/welcome.html")
    .put_private("sent_at", chrono::Utc::now().to_rfc3339())

pub fn is_valid(&self) -> bool

Check if the email has all required fields for sending.

pub fn all_recipients(&self) -> Vec<&Address>

Get all recipients (to + cc + bcc).

pub fn has_attachments(&self) -> bool

Check if the email has any attachments.

pub fn inline_attachments(&self) -> Vec<&Attachment>

Get inline attachments only.

pub fn regular_attachments(&self) -> Vec<&Attachment>

Get regular (non-inline) attachments only.

Trait Implementations

impl Clone for Email

fn clone(&self) -> Email

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Email

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Email

fn default() -> Email

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Email

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Email

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.