Getting started

Quickstart

Prerequisites

Before you start, ensure you have:

A Lettermint account (sign up here if needed)
A verified sending domain
Your API token from the Lettermint dashboard

Step 1: Get Your API Token

Log into your Lettermint dashboard
Navigate to Projects → [Your Project] → API Token
Copy your API token

Your API token grants full access to send emails on your behalf. Never expose it in client-side code, public repositories, or logs. Store it securely as an environment variable.

API token location in the Lettermint dashboard

Step 2: Send Your First Email

Choose your preferred method:

Install the SDK first: npm install lettermint (Node.js), composer require lettermint/lettermint-php (PHP), or pip install lettermint (Python).

Expected Response

A successful request returns a 202 Accepted response:


Code
{
  "message_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "pending"
}

Lettermint does not have a rate limit on its sending API. Send as many emails as you need without worrying about throttling.

Step 3: Check Your Emails

Go to the Emails overview in your dashboard to see your email's delivery status.

Next Steps

Explore SDKs

Official libraries for Node.js, PHP, Python, and more.

API Reference

Complete endpoint documentation with request/response examples.

Set Up Webhooks

Receive real-time notifications for delivery events.

Domain Configuration

Configure DNS records for optimal deliverability.

Going Further

Once you're comfortable with the basics, explore advanced features:

Idempotency — Prevent duplicate sends with idempotency keys
Tags — Organize and filter emails with custom tags
HTML Content — Send rich HTML emails alongside plain text
Tracking — Monitor opens and clicks with built-in tracking

Need help? Create a support ticket on your support page.

Last modified on May 11, 2026

Introduction Node.js

Step 2: Send Your First Email

Choose your preferred method:

import { Lettermint } from "lettermint";

const email = Lettermint.email(process.env.LETTERMINT_PROJECT_TOKEN!);

const response = await email
  .from("You <you@yourdomain.com>")
  .to("recipient@example.com")
  .subject("Hello from Lettermint!")
  .text("This is my first email sent via Lettermint.")
  .send();

console.log(`Email sent with ID: ${response.message_id}`);

Install the SDK first: npm install lettermint (Node.js), composer require lettermint/lettermint-php (PHP), or pip install lettermint (Python).

Expected Response

A successful request returns a 202 Accepted response:

Code

{
  "message_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "pending"
}

Lettermint does not have a rate limit on its sending API. Send as many emails as you need without worrying about throttling.

Going Further

Once you're comfortable with the basics, explore advanced features:

Idempotency — Prevent duplicate sends with idempotency keys

Tags — Organize and filter emails with custom tags

HTML Content — Send rich HTML emails alongside plain text

Tracking — Monitor opens and clicks with built-in tracking

Need help? Create a support ticket on your support page.

Last modified on May 11, 2026