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

# Send Email

> Send automated emails through any SMTP server from an AgentVerse orchestration

# Send Email

The **Send Email** node sends emails through an SMTP server. Use it for transactional messages, alerts, reports, and follow-ups inside an orchestration.

<img src="https://mintcdn.com/subverse-611dde60/69oe_C3cham9g3K-/images/agentverse/send-email-action-node.png?fit=max&auto=format&n=69oe_C3cham9g3K-&q=85&s=411e10ee4b8c2c6617d65d3539d21aa1" alt="Send Email Node" width="786" height="1328" data-path="images/agentverse/send-email-action-node.png" />

***

## Credentials

This node requires an **[Email (SMTP / IMAP)](/credentials/types/email-smtp)** credential.

To create a credential:

1. Go to **Settings → Credentials → New Credential**
2. Select **Email (SMTP / IMAP)**
3. Enter your SMTP username, password, host, port, and encryption

***

## Use Cases

* **Order Confirmations**: Email receipts and invoices after a purchase
* **Appointment Reminders**: Send appointment details to customers
* **Status Alerts**: Notify internal teams or customers when events occur
* **Reports**: Email generated summaries or documents
* **Follow-ups**: Send post-call or post-chat summaries

***

## Parameters

| Parameter                        | Type       | Required | Description                                                                                                                    |
| -------------------------------- | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Credential**                   | Credential | Yes      | Select an [Email (SMTP / IMAP)](/credentials/types/email-smtp) credential                                                      |
| **From Email**                   | String     | No       | Sender address in `sender@example.com` or `Name <sender@example.com>` format. Defaults to the credential username when omitted |
| **To Email**                     | String     | Yes      | Recipient email address                                                                                                        |
| **CC Email**                     | String     | No       | CC recipient address                                                                                                           |
| **BCC Email**                    | String     | No       | BCC recipient address                                                                                                          |
| **Reply To**                     | String     | No       | Reply-To address                                                                                                               |
| **Subject**                      | String     | Yes      | Email subject line                                                                                                             |
| **Email Format**                 | Select     | Yes      | `HTML`, `Text`, or `Both` (default: `HTML`)                                                                                    |
| **Text**                         | String     | No       | Plain text body. Shown when Email Format is `Text` or `Both`                                                                   |
| **HTML**                         | String     | No       | HTML body. Shown when Email Format is `HTML` or `Both`. Supports the built-in HTML editor                                      |
| **Attachments**                  | Collection | No       | Files to attach by public link or direct upload. Each attachment requires a file URL; the file name is optional                |
| **Ignore SSL Issues (Insecure)** | Boolean    | No       | Bypass SSL certificate validation (default: disabled)                                                                          |
| **Append Attribution**           | Boolean    | No       | Add a "Sent via SubverseAI" footer (default: disabled)                                                                         |

### Email Format

| Format | Behavior                                                                        |
| ------ | ------------------------------------------------------------------------------- |
| `HTML` | Sends only the HTML body                                                        |
| `Text` | Sends only the plain text body                                                  |
| `Both` | Sends both HTML and plain text; the recipient's client decides which to display |

### Attachments

Each attachment supports:

| Field               | Required | Description                                                                                          |
| ------------------- | -------- | ---------------------------------------------------------------------------------------------------- |
| **Attachment Type** | Yes      | Choose `Link` for an existing URL or `Upload File` to upload a file directly                         |
| **File URL**        | Yes      | Public URL for link mode. In upload mode, this value is set automatically after the file is uploaded |
| **File Name**       | No       | Name shown in the email, e.g. `invoice.pdf`. When omitted, the node derives it from the URL          |

Uploaded files stored by SubverseAI are resolved to a temporary signed URL when the email is sent.

***

## Output Data

A successful send returns:

```json theme={null}
{
  "messageId": "<message-id@example.com>",
  "response": "250 OK",
  "accepted": ["recipient@example.com"],
  "rejected": []
}
```

Reference in downstream nodes:

```
{{ sendEmail.messageId }}
{{ sendEmail.accepted }}
{{ sendEmail.rejected }}
```

***

## Common Patterns

### Attach a File by URL

```
HTTP Request or upstream node (returns a file URL)
  ↓
Send Email (Attachment Type: Link)
```

Map the attachment **File URL** to the upstream URL. You can leave **File Name** blank to derive it automatically from the URL.

### Upload and Attach a File

Choose **Upload File** in the attachment, then drag and drop or select the file. The uploaded file URL is populated automatically.

### Send AI-Generated Follow-up

```
AI Agent Node (generate email subject and body)
  ↓
Send Email (subject and body linked from AI Agent output)
```

***

## Related Nodes

* [HTTP Request](./http-request.md) — Fetch files or data to include in an email
* [SubVerse Agents](./subverse-agents.md) — Hand off email conversations to an AI agent
* [Conditions](./conditions.md) — Branch based on send success or failure

<Tip>
  Link the **Subject**, **HTML**, and **Text** fields from an upstream **AI Agent** node to generate personalized, context-aware emails.
</Tip>

<Warning>
  For Gmail and other providers with app-specific passwords, use the app password in the credential, not your regular account password.
</Warning>