Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.unosend.co/llms.txt

Use this file to discover all available pages before exploring further.

Send emails using SMTP without the need for any external libraries or dependencies. Connect seamlessly with your existing tools and frameworks.

​
SMTP Credentials

Use these credentials to connect any SMTP-compatible application to Unosend:
Smtp
You can find your SMTP credentials in Settings → SMTP or create a new API key in API Keys.

​
Connection Security

STARTTLS (Recommended)

Upgrades the connection to secure. Works with most email clients and services like Supabase.Port 587

SMTPS (Implicit TLS)

Immediately connects via SSL/TLS. Use when your client requires implicit TLS.Port 465

​
Quick Start Examples

import nodemailer from 'nodemailer';

const transporter = nodemailer.createTransport({
  host: 'smtp.unosend.co',
  port: 587,
  secure: false, // true for 465, false for 587
  auth: {
    user: 'emailapikey',
    pass: 'un_your_api_key', // Your API key
  },
});

async function sendEmail() {
  const info = await transporter.sendMail({
    from: 'hello@yourdomain.com',
    to: 'user@example.com',
    subject: 'Hello from Unosend!',
    html: '<h1>It works!</h1>',
  });

  console.log('Message sent:', info.messageId);
}

sendEmail();

​
Email Tracking via SMTP

Track opens and clicks for emails sent via SMTP using custom headers. Add these headers to your email message to enable tracking:
HeaderValuesDescription
X-Unosend-Track-Openstrue or 1Injects a tracking pixel to detect email opens
X-Unosend-Track-Clickstrue or 1Rewrites links to track clicks
X-Unosend-Tagstag1,tag2Add custom tags for categorization (comma-separated)
Tracking headers are automatically removed before the email is delivered, so recipients won’t see them.

​
Examples with Tracking

const info = await transporter.sendMail({
  from: 'hello@yourdomain.com',
  to: 'user@example.com',
  subject: 'Newsletter',
  html: '<h1>Hello!</h1><p>Click <a href="https://example.com">here</a></p>',
  headers: {
    'X-Unosend-Track-Opens': 'true',
    'X-Unosend-Track-Clicks': 'true',
    'X-Unosend-Tags': 'newsletter,january'
  }
});
View open and click events in your Analytics dashboard or receive them via Webhooks.

​
Supported Integrations

Unosend SMTP works with any application that supports SMTP:

Nodemailer

Laravel

Django

Rails

Supabase

WordPress

NextAuth

Auth0

Strapi

Ghost

Discourse

GitLab

​
Next Steps

Domain Verification

Verify your domain for better deliverability

Sending Emails

Learn about advanced email options