Before you begin#
Before you begin, get the SMTP host and the scheme, port, and authentication requirements from the mail service administrator or provider. Copy any credentials from that provider’s own account settings; do not put secret values in documentation.
Supported transport and settings#
The SMTP profile sends through a remote SMTP server. It supports the standard SMTP and SMTPS transport schemes. Enter the host and any authentication details supplied for the SMTP service you plan to use.
- Transport schemes: smtp (default) and smtps.
- Required: SMTP host.
- Optional: SMTP port (default 587), SMTP username, and SMTP password. The password is a secret field.
- Raw DSN override: leave empty to build the transport from the profile fields.
For transport background, see Symfony Mailer documentation.
Create the connection#
- In WordPress admin, open Jooosi Mail → Connections and choose New connection.
- Enter a Connection name.
- Select SMTP in Profile.
- Choose smtp or smtps in SMTP scheme.
- Enter the SMTP host. Set the port, username, and password as required by your SMTP service. The password is stored as a secret.
- Leave Raw DSN override empty to use the profile fields.
- Review the sender and other connection settings relevant to your setup, then choose Create connection.
See the shared Connect a provider guide for the connection workflow.
Verify delivery#
Follow Send a test email and send a real message to a mailbox you can check. Review the attempt in Jooosi Mail → Logs and confirm that it arrives. The test uses the connection’s current SMTP scheme, host, port, and credentials.
Webhooks#
The built-in SMTP profile does not declare provider webhook support. Review SMTP attempts in Jooosi Mail email logs.
Troubleshooting#
- If the connection cannot authenticate, compare the selected scheme, host, and port with the values required by your SMTP service. Add a username and password only when the service requires them.
- If the log records a transport error, use its details to check the remote server’s connection and authentication requirements.