Email

VitNode provides a unified transactional email service accessible via c.get("email"). Emails are rendered using React components, localized to the recipient's language, and delivered through your chosen provider.

Quick startCopy Anchor Link

import { buildRoute } from '@/api/builders'

export const sendWelcomeRoute = buildRoute({
  route: {
    method: 'post',
    path: '/welcome',
    responses: { 200: { description: 'Email sent' } },
  },
  handler: async (c) => {
    const user = c.get('user')

    await c.get('email').send({
      user, // Resolves email address and preferred locale
      subject: 'Welcome to VitNode!',
      content: () => 'Thank you for joining our community.',
    })

    return c.json({ sent: true })
  },
})

deliver() takes an optional idempotencyKey and returns what the provider reported, such as its message id:

const email = await c.get('email').build(args)
const { id } = await c.get('email').deliver(email, {
  idempotencyKey: `order-receipt:${order.id}`, // same key on every retry
})

Adapters whose provider deduplicates on a key, like Resend, forward it - so a retry after an unconfirmed send is not delivered twice. SMTP has no such feature and ignores it. Notification emails use this for every send.

Configuring Email AdaptersCopy Anchor Link

Configure your delivery transport in apps/api/src/vitnode.api.config.ts:

1. Resend AdapterCopy Anchor Link

import { ResendEmailAdapter } from '@vitnode/core/api/adapters/email/resend'

export const vitNodeApiConfig = buildApiConfig({
  email: {
    from: 'noreply@yourdomain.com',
    adapter: ResendEmailAdapter({
      apiKey: process.env.RESEND_API_KEY!,
    }),
  },
})

2. SMTP AdapterCopy Anchor Link

import { SmtpEmailAdapter } from '@vitnode/core/api/adapters/email/smtp'

export const vitNodeApiConfig = buildApiConfig({
  email: {
    from: 'noreply@yourdomain.com',
    adapter: SmtpEmailAdapter({
      host: process.env.SMTP_HOST!,
      port: Number(process.env.SMTP_PORT ?? 587),
      user: process.env.SMTP_USER!,
      password: process.env.SMTP_PASSWORD!,
    }),
  },
})

Testing Email in AdminCPCopy Anchor Link

Verify email configuration in the AdminCP at System → Integrations (/admin/core/system/integrations):

• Click Test Email on the email card.
• Enter an email address to dispatch an immediate test delivery.

Learn MoreCopy Anchor Link