Email workflows

Troubleshoot email connection and sending errors

Email troubleshooting separates provider authentication, transport settings, and workflow execution. Each stage can fail independently.

Updated

By Kition Docs

Verified against Kition 0.2.0 (7d49036f) on 2026-11-06

Identify the failing stage

A failure during Test & Save points to the connection itself; a failure in Run History points to a run, which can fail because of the connection, the recipient, or the message. Start with the action that failed and the error reported for it.

Use the provider’s current account-specific instructions. Presets can become inappropriate when an administrator changes allowed authentication methods or when an account region uses different endpoints. Do not repeatedly submit a password without checking the expected credential type.

Check the connection systematically

  1. Confirm the connection selected in the failed workflow’s Send email action.
  2. Verify provider access and the required credential, such as an app password or authorization code.
  3. Choose Edit connection and compare the host, port, and TLS mode under Advanced with the provider’s current settings.
  4. Choose Test & Save, and check Settings › Network if Kition uses a proxy, which also carries SMTP traffic.
  5. Review the next controlled run and check for partial output before retrying again.

Understand common port and TLS pairings

Conventional SMTP settings, not account guarantees
TransportCommon portKition TLS mode
Implicit TLS (SMTPS)465TLS
STARTTLS upgrade587STARTTLS
Unencrypted SMTPProvider-specificPlain

Interpret an early disconnect

A server can close the connection immediately when the port and TLS mode do not match, which Kition may report as EOF. For example, port 465 with STARTTLS is invalid for 163 Mail and commonly returns EOF during Test & Save. EOF alone does not identify a unique cause, so also check network reachability and the provider’s error details.

For a support report, include the provider name, redacted error, installed Kition version, and whether the failure occurs during Test & Save or a workflow run. Omit passwords, tokens, message bodies, and private attachments. Preserve the existing workflow configuration while investigating so its original behavior remains traceable.

Version and sources

This guide describes the Kition desktop app as of source 7d49036f, checked on 2026-11-06. Connected actions also depend on the configured model provider or service. If your installed version is older, some controls may differ.

Related pages

Ready when you are.

Kition is a desktop AI workspace for connected documents, structured tables, editable designs, whiteboards, visual workflows, and reviewable AI agents.