Email (SMTP / IMAP) Credentials
Email (SMTP / IMAP) credentials let SubverseAI send emails through your own mail server or provider. They are used by the Send Email node and the subverseActions.email.send custom function action.
Required Fields
| Field | Required | Description |
|---|
| Name | Yes | A descriptive name for the credential, e.g. Support Mailbox |
| Username | Yes | SMTP/IMAP auth username — usually the email address of the account |
| Password | Yes | Account password or app-specific password |
| SMTP Host | Yes | Hostname of the outgoing SMTP server |
| SMTP Port | Yes | Port for the SMTP server |
| Encryption | Yes | SSL/TLS, STARTTLS, or None |
| IMAP Host | No | Hostname of the incoming IMAP server (required only to receive emails) |
| IMAP Port | No | Port for the IMAP server |
Provider Settings
Gmail / Google Workspace
Gmail requires an App Password when 2-Factor Authentication is enabled. Generate it in your Google Account → Security → App passwords.
Outlook / Microsoft 365
Zoho Mail
Custom SMTP Server
Use the hostname, port, and encryption settings provided by your mail server or hosting provider.
Steps to Create
- Go to Settings → Credentials → New Credential
- Select Email (SMTP / IMAP)
- Enter a descriptive Name
- Fill in Username, Password, SMTP Host, SMTP Port, and Encryption
- Add IMAP Host and IMAP Port only if the credential will also receive emails
- Save the credential
Usage
Once saved, select this credential in:
Troubleshooting
Authentication failed
- Use an app password instead of your regular password for Gmail and similar providers
- Verify the username matches the full email address
- Check that the encryption type matches the port
Connection timed out
- Confirm the SMTP host and port are correct
- Check firewall or network restrictions on port 465/587
Emails going to spam
- Send from a legitimate business domain
- Configure SPF, DKIM, and DMARC records for your domain
- Avoid spam-like content and excessive punctuation
