Send Email

Install

npm install @bytewise-solutions/mailverick

Send an email

The SDK handles token exchange and refresh automatically. Pass your API key credentials and send.

import { Mailverick } from "@bytewise-solutions/mailverick";

const client = new Mailverick("mvk_id_xxx", "mvk_sec_xxx");

await client.sendEmail({
  from: { email: "you@yourdomain.com" },
  to: [{ email: "recipient@example.com" }],
  subject: "Order confirmation #1234",
  body: {
    html: "<h1>Thank you!</h1>",
    text: "Thank you! Your order has been confirmed.",
  },
  custom_id: "order-1234",
  tracking: { opens: "last_only", disabled: false },
});

Parameters

Configuration

No token needed. Authenticate directly with your API key credentials. Drop-in replacement for any SMTP configuration.

Use port 465, which encrypts the connection before any data is sent. Port 587 is also supported and upgrades to TLS with STARTTLS. Cleartext authentication is refused on both, so your client has to complete TLS before it authenticates.

Framework examples

SMTP_HOST=smtp.mailverick.com
# Use 587 with STARTTLS, or 465 with implicit TLS. Cleartext auth is refused.
# Django and Spring need their TLS setting enabled explicitly.
SMTP_PORT=587
SMTP_USER=mvk_id_xxxxxxxxxx
SMTP_PASS=mvk_sec_xxxxxxxxxx

const nodemailer = require("nodemailer");

const transporter = nodemailer.createTransport({
  host: "smtp.mailverick.com",
  port: 465,
  secure: true,
  auth: {
    user: "mvk_id_xxxxxxxxxx",
    pass: "mvk_sec_xxxxxxxxxx",
  },
});

await transporter.sendMail({
  from: "you@yourdomain.com",
  to: "recipient@example.com",
  subject: "Order confirmation #1234",
  html: "<h1>Thank you!</h1>",
});

# settings.py
EMAIL_HOST = "smtp.mailverick.com"
EMAIL_PORT = 465
EMAIL_HOST_USER = "mvk_id_xxxxxxxxxx"
EMAIL_HOST_PASSWORD = "mvk_sec_xxxxxxxxxx"
EMAIL_USE_SSL = True

# .env
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailverick.com
MAIL_PORT=465
MAIL_USERNAME=mvk_id_xxxxxxxxxx
MAIL_PASSWORD=mvk_sec_xxxxxxxxxx
MAIL_ENCRYPTION=ssl

# application.properties
spring.mail.host=smtp.mailverick.com
spring.mail.port=465
spring.mail.username=mvk_id_xxxxxxxxxx
spring.mail.password=mvk_sec_xxxxxxxxxx
spring.mail.properties.mail.smtp.ssl.enable=true