Skip to content

Egress SMTP

Responsibility

Outbound email capability provider for workflow service_call steps.

Capabilities:

  • egress.smtp.call — send mail (POST /call)
  • connection type via registry designer metadata

Architecture

Capability provider (see Deploy integration contract):

  • Registers with capability-registry at startup
  • Orchestrator discovers the endpoint via the registry
  • No first-class type: smtp_send step — use service_call

Inbound Authentication

  • internal-only service, called by orchestrator after registry lookup

Outbound Authentication

  • SMTP username/password from connection payload
  • TLS/SSL mode depending on provider

Example workflow step

- id: send_mail
  type: service_call
  capability_name: egress.smtp.call
  capability_version: "^1.0"
  path: /call
  connection: my_smtp
  # first-class fields (to_emails, subject, …) preferred — see Workflow YAML

Key Config

  • use_tls, use_ssl, attachment constraints

Health

  • GET /healthz
  • GET /readyz
  • GET /internal/capabilities