Skip to main content

​
What are Routes?

Routes define how emails are processed within your project. Each route type is optimized for specific email use cases and comes with tailored features.

​
Route Types

​
Transactional Routes

Transactional routes are designed for critical, one-to-one emails triggered by user actions. Use cases:
  • Password reset emails
  • Order confirmations
  • Account verification emails
  • Shipping notifications
  • Two-factor authentication codes
Features:
  • High priority delivery
  • Dedicated infrastructure not shared with marketing campaigns
Best practices:
  • Use a dedicated transactional route for critical emails
  • Never include marketing content in transactional emails
  • Monitor delivery rates closely

​
Broadcast Routes

Broadcast routes are optimized for one-to-many email campaigns sent to multiple recipients. Use cases:
  • Marketing newsletters
  • Product announcements
  • Weekly digests
  • Promotional campaigns
  • Community updates
Features:
  • Built-in unsubscribe handling
  • Hosted unsubscribe pages (can be disabled on higher plans)
  • Bulk sending optimization
The hosted unsubscribe feature automatically adds an unsubscribe link to broadcast emails and manages the unsubscribe page. Disabling this requires you to handle unsubscribes yourself. In order to be able to change this setting, contact support. This option is only granted to trusted senders.

​
Inbound Routes

Inbound routes allow you to receive emails and process them via webhooks. Perfect for support systems, email-based workflows, and automated processing. Use cases:
  • Support ticket systems
  • Email-to-task conversions
  • Reply tracking
  • Email parsing and automation
  • Customer feedback collection
Features:
  • Unique email address per route
  • Custom domain support with MX records
  • Configurable spam filtering
  • Full email parsing (headers, body, attachments)
  • Webhook delivery with complete email data
  • Subaddress support (e.g., user+tag@example.com)
Inbound routes are available on Starter plans and above. See the Inbound Mail guide for detailed setup instructions.

​
Managing Routes

​
Creating a Route

  1. Navigate to your project in the dashboard
  2. Go to the Routes section
  3. Click Create Route
  4. Choose your route type
  5. Configure route settings
  6. Save your route

​
Route Settings

Different route types have different available settings: All Routes:
  • Name and description
  • Webhook configuration
  • Suppression list management
Broadcast Routes:
  • Hosted unsubscribe settings
Inbound Routes:
  • Spam threshold configuration
  • Custom domain setup

​
Webhooks per Route

Each route can have its own webhook endpoints to receive delivery events:
  • Transactional/Broadcast: Receive message.sent, message.delivered, message.bounced, etc.
  • Inbound: Receive message.inbound events with full email content
See the Webhooks documentation for configuration details.

​
Suppression Lists

Routes maintain suppression lists to prevent sending to:
  • Hard bounced addresses
  • Spam complainers
  • Manually suppressed recipients
Suppression scope:
  • Route-level: Applied only to the specific route
  • Project-level: Applied across all routes in the project
  • Team-level: Applied across all projects in your team

​
Choosing the Right Route Type

Transactional

When to use:
  • User triggered
  • Time-sensitive
  • Mission-critical
  • Account-related

Broadcast

When to use:
  • Marketing content
  • Multiple recipients
  • Campaigns
  • Newsletters

Inbound

When to use:
  • Receiving emails
  • Support systems
  • Reply processing
  • Email automation
Don’t mix email types! Using a transactional route for marketing or vice versa can harm deliverability and violate anti-spam regulations.

​
Next Steps