Skip to content
Help Center
Submit a request Sign in

Configure an outgoing SMTP connector

An outgoing SMTP connector sends Supportbench email through your organization’s mail service. Use it when your outbound-delivery policy requires a specific relay, while keeping provider authentication and TLS requirements explicit.

Applies to: Supportbench Core. Location: Settings → Email configuration → SMTP (outbound email). Editing requires Administer email routes.

Before you begin

  • Obtain the SMTP server, port, authentication and TLS requirements from your email administrator. Keep the password out of screenshots and customer-facing articles.
  • Configure an active reply address on your organization’s own domain first. The enabled connector uses it as the verification sender.
  • Plan a controlled delivery test and review any account-wide delivery pause. A connector setting cannot override that pause.

Configure and verify

  1. Open Settings → Email configuration → SMTP (outbound email). Enter Server and Port, then Username and Password if the server requires authentication.
  2. Review Require TLS. Port 465 uses direct TLS; other TLS ports use STARTTLS with strict certificate validation. Use the server’s actual supported settings.
  3. For an existing connector, a blank Password retains the saved secret. Password is write-only and supports up to 63 ASCII characters; do not interpret a blank display as proof that no password is stored.
  4. Choose Use this connector when ready to enable it, then Save Changes. Enabled saves validate the destination and send an SMTP verification before persisting. If verification fails, the settings are not saved.
  5. To store configuration without network verification, leave the connector inactive and save. Delivery then continues through the shared Supportbench service.
  6. After an enabled save succeeds, send an approved controlled customer-message test and inspect delivery and the reply address. A settings success is not evidence that every recipient mailbox accepts mail.
  7. Use Remove connector only when intentionally returning to shared delivery. Queued mail remains intact; verify the resulting delivery path.

Settings reference

Connection, security and delivery

SettingWhat it controlsHow to choose
ServerSMTP hostname or IP address, without a URL scheme. Unsafe or local-only destinations are rejected.Use the hostname provided for the approved SMTP service.
PortThe provider’s SMTP listener. Port 465 uses direct TLS; other secure ports use STARTTLS.Match the provider’s documented listener and TLS mode.
UsernameSMTP account username, up to 100 characters, when authentication is required.Use the credential issued for this connector.
PasswordWrite-only connector secret; blank preserves an existing stored password. Replacement is limited to 63 ASCII characters.Enter a replacement only when changing the credential; the stored secret is never displayed.
Require TLSRequires strict certificate validation and encrypted negotiation.Keep encryption requirements consistent with the approved relay; resolve certificate problems at the provider.
Use this connectorUses this connector for delivery when enabled; otherwise the shared Supportbench service is used.Activate after the connection details are ready.
Remove connectorRemoves the custom SMTP configuration.Review the fallback delivery path before removing it.

Behavior to know

  • Account-wide delivery pause overrides connector readiness. The page displays a pause notice when applicable.

Recommended use

  • Treat an inactive save as configuration storage, not proof of connectivity.
  • Retain the existing secret by leaving its field blank when changing unrelated options.
  • Existing anonymous relays can show authentication as unnecessary; follow the form’s available controls.

Worked example

  1. Obtain the approved relay hostname, port and credentials.
  2. Configure the connector and require the provider’s supported TLS mode.
  3. Enable Use this connector and save.
  4. Confirm the verification succeeds, then inspect a controlled outbound response.

Troubleshooting

ProblemWhat to check
Enabled Save fails verificationCheck the active own-domain reply address, server/port, credentials, TLS compatibility and certificate validity. The rejected settings were not persisted.
The password field is blank after reopeningThat is expected for a write-only secret; blank input preserves the existing password.
Mail still uses shared deliveryCheck whether Use this connector was enabled and its verification/save succeeded. Inactive configuration does not select the connector.
No messages leave despite a valid connectorCheck account-wide delivery pause and actual queued/delivery evidence.
Mail fails only for some recipientsInspect the returned delivery error and the provider’s acceptance/rejection evidence; do not infer universal delivery from a successful verification.
  • Email configuration → Configure reply addresses and signatures
  • Email configuration → Manage email block and allow rules

Was this article helpful?