> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subverseai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Email (SMTP / IMAP) Credentials

> How to create and configure Email (SMTP / IMAP) credentials for sending emails from SubverseAI

# 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](/agentverse/nodes/email) node and the [`subverseActions.email.send`](/integrations/agentic-functions/custom-function-actions#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

```
SMTP Host: smtp.gmail.com
SMTP Port: 465
Encryption: SSL/TLS
Username: your-address@gmail.com
Password: <App Password>
```

<Warning>
  Gmail requires an **App Password** when 2-Factor Authentication is enabled. Generate it in your Google Account → Security → App passwords.
</Warning>

### Outlook / Microsoft 365

```
SMTP Host: smtp.office365.com
SMTP Port: 587
Encryption: STARTTLS
Username: your-address@company.com
Password: <account password>
```

### Zoho Mail

```
SMTP Host: smtp.zoho.com
SMTP Port: 587
Encryption: STARTTLS
Username: your-address@zoho.com
Password: <account password or app password>
```

### Custom SMTP Server

Use the hostname, port, and encryption settings provided by your mail server or hosting provider.

***

## Steps to Create

1. Go to **Settings → Credentials → New Credential**
2. Select **Email (SMTP / IMAP)**
3. Enter a descriptive **Name**
4. Fill in **Username**, **Password**, **SMTP Host**, **SMTP Port**, and **Encryption**
5. Add **IMAP Host** and **IMAP Port** only if the credential will also receive emails
6. Save the credential

***

## Usage

Once saved, select this credential in:

* [Send Email node](/agentverse/nodes/email) — send emails from an orchestration
* [`subverseActions.email.send`](/integrations/agentic-functions/custom-function-actions#email-send) — send emails from a custom function

***

## 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