Skip to content

Configure Email Service Default Settings

Add support for configurable default email settings via environment variables. Allow from_address, reply_to_address, and from_name to be optional in message payload.

Note:

  • Environment variables for defaults:
  • DEFAULT_FROM_ADDRESS - default sender email address
  • DEFAULT_FROM_NAME - default sender display name
  • DEFAULT_REPLY_TO_ADDRESS - default reply-to email address
  • Behavior: Use env var defaults when fields not provided in message payload
  • Allow per-message override: If fields provided in payload, use those instead of defaults
  • Validation: Ensure at least one source (env var or payload) provides required from_address

Example(s):

Environment configuration: 

DEFAULT_FROM_ADDRESS="noreply@astrata.team"
DEFAULT_FROM_NAME="Astrata Portal"
DEFAULT_REPLY_TO_ADDRESS="support@astrata.team"

Message without overrides (uses defaults): 

{
  "to_addresses": ["user@example.com"],
  "template": "magic-link-login",
  "namespace": "portal",
  "template_vars": {}
}

Message with overrides (ignores defaults): 

{
  "to_addresses": ["user@example.com"],
  "template": "magic-link-login",
  "namespace": "aktion",
  "template_vars": {},
  "from_address": "aktion@example.com",
  "from_name": "Aktion Portal"
}