Copy page

SMTP

Nodemailer

Installation

Install nodemailer via your package manager:

Basic Configuration

Use environment variables for credentials:

Code
const SMTP_HOST = 'smtp.lettermint.co';
const SMTP_USERNAME = 'lettermint';
const API_TOKEN = process.env.LETTERMINT_PROJECT_TOKEN;

Advanced Features

Multiple Recipients

Code
const mailOptions = {
  from: 'sender@yourdomain.com',
  to: ['user1@example.com', 'user2@example.com'],
  cc: 'manager@yourdomain.com',
  bcc: 'archive@yourdomain.com',
  subject: 'Newsletter',
  html: '<h1>Monthly Update</h1>',
};

Attachments

Code
const mailOptions = {
  from: 'sender@yourdomain.com',
  to: 'recipient@example.com',
  subject: 'Document Attached',
  html: '<p>Please find the document attached.</p>',
  attachments: [
    {
      filename: 'document.pdf',
      path: './files/document.pdf',
    },
    {
      filename: 'data.json',
      content: JSON.stringify({ key: 'value' }),
    },
  ],
};

Custom Headers

Code
const mailOptions = {
  from: 'sender@yourdomain.com',
  to: 'recipient@example.com',
  subject: 'Custom Headers',
  html: '<p>Email with custom headers.</p>',
  headers: {
    'X-Priority': '1',
    'X-Custom-Header': 'Custom Value',
  },
};

Metadata for Tracking

Add metadata that will be included in webhook payloads:

Code
const mailOptions = {
  from: 'sender@yourdomain.com',
  to: 'recipient@example.com',
  subject: 'Order Confirmation',
  html: '<p>Your order has been confirmed.</p>',
  headers: {
    'X-LM-Metadata-order_id': '12345',
    'X-LM-Metadata-customer_id': 'cust_789',
    'X-LM-Metadata-campaign': 'order_confirmation',
  },
};

Lettermint Headers

Add Lettermint-specific headers for tags, metadata, and routing:

Code
const mailOptions = {
  from: 'sender@yourdomain.com',
  to: 'recipient@example.com',
  subject: 'Order Confirmation',
  html: '<p>Your order has been confirmed.</p>',
  headers: {
    // Tag for categorization
    'X-LM-Tag': 'order-confirmation',
    // Metadata for tracking (included in webhooks)
    'X-LM-Metadata-order_id': '12345',
    'X-LM-Metadata-customer_id': 'cust_789',
    // Route selection
    'X-Lettermint-Route': 'transactional',
  },
};