Skip to main content

Email overview

The Email service controls how your app sends product and account messages. It covers sender identity, provider routes, templates, workflow timing, built-in transactional emails, suppressions, and delivery runtime.

Switera email overview with setup guidance and email tabs
Start on the Email overview. It points to the next sender, template, or runtime task that matters for this app.

Email areas​

AreaUse it for
OverviewReadiness, delivery health, and next actions.
Sender & BrandSender identity, reply-to behavior, delivery identity, and email appearance.
AutomationWorkflow timing and built-in message sequences.
TemplatesInvitation templates and custom email copy.
Built-inAccount, security, verification, recovery, and lifecycle emails.

First email setup​

  1. Open Services > Email.
  2. Open Sender & Brand.
  3. Confirm who email comes from.
  4. Confirm reply-to behavior.
  5. Preview the invitation or account email.
  6. Open Templates and create or review the invitation template.
  7. Open Built-in and review account/security emails.
  8. Open Automation and check when each message sends.
  9. Send test messages to a monitored mailbox before inviting users.

Generate integration recipes​

The Email overview includes an Integration recipes panel for backend smoke checks and runtime monitoring. Use it after you create an app API key and before you invite real users.

The panel generates:

  • .env.example entries for the app ID, server-side API key, monitored test recipient, workflow key, built-in email kind, and locale
  • a server-side smoke route or job that runs a sender route test, a workflow test-run, and a built-in preview send
  • a runtime monitor that reads /api/v1/apps/{appId}/email/runtime and highlights failed, bounced, suppressed, complained, or retrying messages

Supported launch stacks are SvelteKit endpoints, Next.js route handlers, Express APIs, Go jobs, and Python jobs. Keep the app API key server-side only. Do not call Email smoke or runtime endpoints directly from browser code.

Switera email sender and brand workspace with preview
The Sender & Brand tab shows the visible email identity and a preview of what recipients will see.

Runtime monitoring​

The runtime view helps answer:

  • was the message rendered?
  • was it queued?
  • did it send?
  • did it bounce or get marked as spam?
  • is the recipient suppressed?
  • can the message be resent?
  • which workflow produced the message?

Launch checklist​

  • sender identity is recognizable
  • reply-to behavior is intentional
  • invitation template is clear
  • verification and recovery emails work
  • built-in emails match product tone
  • automation timing is reviewed
  • test sends reach a monitored mailbox
  • bounced or suppressed recipients are reviewed

Use email carefully​

Email is user-visible and reputation-sensitive. Before launch:

  • use a verified sender domain when available
  • avoid misleading sender names
  • keep templates short and clear
  • test every locale you enable
  • review suppressions and bounced recipients
  • avoid sending bulk messages from an untested route

Related pages: