How to Use Gmail SMTP with Void Relay: A Complete Setup Guide

Gmail and Google Workspace are popular choices for sending transactional emails, especially for startups and small businesses. With Void Relay, you can use Gmail's reliable infrastructure while getting modern API features like webhooks, analytics, and easy integration. Here is how to set it up.

Step 1: Enable 2-Factor Authentication

Before you can use Gmail SMTP with Void Relay, you need to enable 2-factor authentication on your Google account:

1. 1. Go to your Google Account Security settings
2. 2. Under "Signing in to Google", click "2-Step Verification"
3. 3. Follow the prompts to enable it

Step 2: Generate an App Password

Once 2FA is enabled, you need to create an App Password specifically for Void Relay:

1. 1. Go to App Passwords
2. 2. Select "Mail" as the app
3. 3. Select your device (or "Other")
4. 4. Click "Generate"
5. 5. Copy the 16-character password (without spaces)

Important: This is the password you will use in Void Relay, not your regular Gmail password.

Step 3: Add SMTP Config in Void Relay

Log in to your Void Relay dashboard and add a new SMTP configuration:

• • Host: smtp.gmail.com
• • Port: 587
• • Username: Your full Gmail address
• • Password: The App Password from Step 2
• • Encryption: STARTTLS

Step 4: Send Your First Email

Once configured, you can start sending emails through Gmail using the Void Relay API:

import { RelayClient } from '@voidvalue/relay';

const relay = new RelayClient({
  apiKey: 'your-api-key',
  smtpKey: 'your-smtp-key',
}});

await relay.send({
  to: '[email protected]',
  subject: 'Hello from Gmail SMTP!',
  content: '<p>This email was sent through Gmail using Void Relay.</p>',
  isHtml: true,
}});

Gmail Limits to Know

Gmail has sending limits you should be aware of:

• • Free Gmail: 500 emails per day
• • Google Workspace: 2,000 emails per day
• • Recipients per email: 100 maximum

For higher volumes, consider upgrading to Google Workspace or using AWS SES.