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
- Confirm the connection selected in the failed workflow’s Send email action.
- Verify provider access and the required credential, such as an app password or authorization code.
- Choose Edit connection and compare the host, port, and TLS mode under Advanced with the provider’s current settings.
- Choose Test & Save, and check Settings › Network if Kition uses a proxy, which also carries SMTP traffic.
- Review the next controlled run and check for partial output before retrying again.
Understand common port and TLS pairings
| Transport | Common port | Kition TLS mode |
|---|---|---|
| Implicit TLS (SMTPS) | 465 | TLS |
| STARTTLS upgrade | 587 | STARTTLS |
| Unencrypted SMTP | Provider-specific | Plain |
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
Connect an email provider in Kition
An email connection stores the SMTP account a workflow uses to send messages. You create it from a workflow’s Send email action and can reuse it in other workflows.
Send email from a visual workflow
The Send email action delivers a message through a selected SMTP connection. A tested connection and a reviewed recipient, subject, and body are all required for a useful result.
Inspect workflow runs and diagnose failures
Workflow run history is the record of executions and their outcomes. It connects a configured process with evidence of what actually happened.