Quickstart
Prerequisites
Before you start, ensure you have:
- A Lettermint account (sign up here if needed)
- A verified sending domain
- A Project API token from the Lettermint dashboard
Step 1: Create a Project API Token
- Log into your Lettermint dashboard.
- Navigate to Projects → [Your Project] → API Tokens.
- Click Create token.
- Give the token a descriptive name, such as
Quickstart local. - Copy the value and store it as
LETTERMINT_PROJECT_TOKEN.
Your Project API token can send email for its project. Never expose it in client-side code, public repositories, or logs. Store it securely as an environment variable.
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
Lettermint does not throttle the Sending API send endpoints. Plan quota, spend limits, account verification, reputation, and abuse controls can still limit or pause sending.
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.