Transactional

Email Servers

Organize your email infrastructure with servers - logical containers for your sending configuration.

What is an Email Server?

An email server is a logical container that groups related email sending configuration. Think of it as a project or application boundary for your emails.

Each server has its own:

  • Message Streams - Separate channels for different email types
  • Sender Identities - Verified sender addresses
  • API Keys - Authentication credentials
  • Suppressions - Bounced and unsubscribed addresses
  • Analytics - Delivery metrics and activity logs

When to Create Multiple Servers

Separate Environments

Create different servers for development, staging, and production:

├── my-app-development
├── my-app-staging
└── my-app-production

This keeps test emails separate from production and prevents accidental sends.

Multiple Applications

If you have multiple products or applications, give each its own server:

├── main-app
├── admin-portal
└── marketing-site

Different Clients (Agencies)

If you manage emails for multiple clients, use separate servers:

├── client-acme-corp
├── client-globex
└── client-initech

Creating a Server

Via Dashboard

  1. Navigate to Email > Servers
  2. Click Create Server
  3. Fill in the details:
    • Name - A descriptive name for the server
    • Color - Optional color for visual identification
  4. Click Create

Via API

const server = await client.servers.create({
  name: 'My Application',
});

Server Settings

General Settings

  • Name - Display name for the server
  • Color - Visual identifier in the dashboard

Delivery Settings

  • Default Stream - Which stream to use when none is specified
  • Tracking Domain - Custom domain for open/click tracking

Suppression Settings

  • Auto-suppress bounces - Automatically add hard bounces to suppression list
  • Auto-suppress complaints - Automatically add spam complaints to suppression list

Server Limits

PlanMax Servers
Free1
Pro5
EnterpriseUnlimited

API Keys

Each server can have multiple API keys with different permissions:

  • Full Access - Send emails and manage server settings
  • Send Only - Only send emails, no management access

See API Keys for more details.

Deleting a Server

Deleting a server permanently removes:

  • All message streams
  • All sender identities
  • All API keys
  • All email logs and analytics
  • All suppression entries

This action cannot be undone.

Next Steps