Set up SMTP on your platform

Samva's email SMTP relay works with any platform that supports custom SMTP. Below are step-by-step setups for popular platforms.

Auth0

Auth0 uses SMTP to send verification emails, password resets, and MFA codes.

1. Go to Auth0 Dashboard → Branding → Email Provider
2. Select Custom Email Provider
3. Enter the following settings:

4. Set the From address to an address on your verified Samva domain (e.g., auth@yourdomain.com)
5. Click Save. While SMTP is staged, the connection authenticates but message submissions are not yet accepted

Supabase

Supabase uses SMTP for authentication emails (signup confirmation, password reset, magic links).

1. Go to Supabase Dashboard → Project Settings → Authentication
2. Scroll to SMTP Settings and enable Custom SMTP
3. Enter the following:

4. Set Minimum interval between emails as needed
5. Click Save

While SMTP is staged, Supabase can save and authenticate the connection, but message submissions are not yet accepted.

WordPress

Use the WP Mail SMTP plugin to route WordPress emails through Samva.

1. Install and activate the WP Mail SMTP plugin
2. Go to WP Mail SMTP → Settings → General
3. Under Mailer, select Other SMTP
4. Configure:

5. Set the From Email to an address on your verified domain
6. Save the settings. While SMTP is staged, the connection authenticates but message submissions are not yet accepted

Customer.io

Customer.io can use a custom SMTP relay for sending transactional and marketing emails.

1. Go to Customer.io → Settings → Email
2. Under Sending Configuration, select Custom SMTP
3. Enter:

4. Set your default From address to one on your verified domain
5. Save the configuration. While SMTP is staged, the connection authenticates but message submissions are not yet accepted

Nodemailer (Node.js)

For Node.js applications using Nodemailer, configure the transport now so it is ready when SMTP submissions go live. While SMTP is staged, the relay authenticates but does not yet accept message submissions — use the API or SDK to send today.

import nodemailer from "nodemailer";

const transporter = nodemailer.createTransport({
  host: "smtp.samva.app",
  port: 587,
  secure: false, // false for STARTTLS, true for port 465
  auth: {
    user: "samva",
    pass: process.env.SAMVA_API_KEY,
  },
});

// Once SMTP submissions are enabled, send an email
const info = await transporter.sendMail({
  from: '"Your App" <noreply@yourdomain.com>',
  to: "user@example.com",
  subject: "Welcome!",
  html: "<h1>Welcome to our app!</h1>",
});

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

For connection pooling in production:

const transporter = nodemailer.createTransport({
  host: "smtp.samva.app",
  port: 587,
  secure: false,
  auth: {
    user: "samva",
    pass: process.env.SAMVA_API_KEY,
  },
  pool: true, // Use connection pooling
  maxConnections: 5, // Max simultaneous connections
  maxMessages: 100, // Max messages per connection
});

Verification checklist

While SMTP is staged, you can confirm your configuration connects and authenticates even though message submissions are not yet accepted:

1. Save your SMTP settings on the platform and use its connection or authentication test if it has one
2. Confirm the connection succeeds and your API key is accepted

Once SMTP submissions are enabled, messages sent through the relay route through the same delivery pipeline as API sends, so they will appear in your Samva dashboard and share the same delivery and tracking handling as API-sent email.

To send and track email today, use the API or SDK. For connection settings, limits, and troubleshooting, see the SMTP reference.