Getting Started

This guide walks you through setting up NevarMail, connecting your first email provider, and sending your first email.

Prerequisites

• A NevarMail account (sign up free)
• API credentials for at least one supported email provider (SendGrid, Mailgun, Amazon SES, Postmark, or any SMTP server)

Step 1: Connect a provider

After signing in, navigate to the Providers page and add your email provider credentials. NevarMail will verify the connection automatically.

# Example: configure SendGrid via environment variable
SENDGRID_API_KEY=SG.your-api-key-here

See Providers for the full list of supported providers and their configuration options.

Step 2: Verify a sender

Before you can send email, you need at least one verified sender identity. Go to the Senders page and create a sender with your from address.

POST /api/senders
{
  "name": "My App",
  "fromEmail": "hello@yourdomain.com",
  "fromName": "My Application"
}

See Senders for more details on sender management and verification.

Step 3: Send your first email

With a provider connected and a sender verified, you can send your first email:

POST /api/email/send
{
  "to": "recipient@example.com",
  "subject": "Hello from NevarMail!",
  "html": "<h1>It works!</h1><p>Your NevarMail integration is live.</p>",
  "text": "It works! Your NevarMail integration is live."
}

The response includes a unique message ID and delivery status:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "messageId": "msg-abc123@yourdomain.com",
  "status": "sent",
  "provider": "sendgrid",
  "sentAt": "2026-03-22T12:00:00.000Z"
}

Step 4: Set up your domain (optional)

For the best deliverability, configure your sending domain with proper DNS records. NevarMail automates SPF, DKIM, and DMARC configuration.

See Domains for setup instructions.

Next steps

• Authentication -- Learn about API keys and session-based auth
• Sending Email -- Explore all sending options including templates and scheduling
• Templates -- Create reusable email templates with variables
• Analytics -- Monitor delivery metrics