SMTP

SMTP is the compatibility connector. It is useful for legacy mail servers, private infrastructure, or providers that only issue SMTP credentials.

Before you start

• Collect the SMTP host, port, username, and password.
• Confirm whether the server requires TLS, STARTTLS, or plain SMTP on a private network.
• Check whether your provider has separate webhook support. SMTP alone cannot report most downstream recipient events.

Setup

flowchart LR
  MG[GenieOS] --> Auth[SMTP authentication]
  Auth --> Server[SMTP server]
  Server --> MX[Recipient mail servers]
  MX --> Inbox[Recipient inbox]
  Server -. optional provider webhook .-> MG

1. Open Settings -> Connectors and choose SMTP.
2. Enter the host, port, username, password, and security mode.
3. Configure the default from address.
4. Send a connector test.
5. If your SMTP provider has a webhook product, add the webhook URL shown in GenieOS.

Capabilities

Webhooks and suppressions

SMTP handoff only proves that the SMTP server accepted the message. It does not guarantee inbox delivery. If you need delivered, bounced, complained, opened, or clicked events, choose an API ESP connector or configure a provider webhook outside the SMTP protocol.

Troubleshooting

• Authentication failures usually mean the provider requires an app password or SMTP-specific credential.
• Connection failures usually mean the host, port, or TLS mode is wrong.
• Throttling can appear as temporary SMTP failures. Lower volume or ask the provider for higher limits.