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

# Email Notification

[Updated in 2026.23](https://docs-classic.cognigy.com/release-notes/2026.23.md)

![Email Notification Node configuration panel](https://mintcdn.com/cognigy-docs-legacy/sbu8K_1z3Hht9e7i/_assets/ai/develop/node-reference/email-notification.png?fit=max\&auto=format\&n=sbu8K_1z3Hht9e7i\&q=85\&s=333822aa32a49b34108382f9e6506a78)

## Description

The Email Notification Node lets you send quick, easy emails during sessions or for in-house communications without setting up any provider settings in the UI. Instead, you can configure the necessary provider settings in the environment variables and secrets. You can set up only one provider at a time.

## Restrictions

* Your SMTP Server settings need to be adjusted to use the internal Cognigy Email notification.
* Email attachments are restricted (for example, files, images). If required, use [Send SMTP Email Node](https://docs-classic.cognigy.com/ai/agents/develop/node-reference/data/send-smtp-email.md).

## Authentication

This Node supports both Basic Auth and OAuth2 authentication methods.

If you have an on-premises installation, you need to add the following parameters to the `values.yaml` file:

> [tab] OAuth2 (recommended)
>
> object:
>
> ```yaml theme={null}
> smtpEmailNotificationCredentials:
>  authType: "oauth2"
>  oauth2:
>    user: "<smtp-server>@domain.com"
>    clientId: "your client id"
>    clientSecret: "your client secret"
>    refreshToken: "your refresh token"
>    accessToken: "your access token"
> ```
>
> variables:
>
> ```yaml theme={null}
> EMAIL_NOTIFICATION_SMTP_FROM: "<smtp-server>@domain.com"
> EMAIL_NOTIFICATION_SMTP_AUTH_TYPE: "oauth2"
> EMAIL_NOTIFICATION_SMTP_EMAIL_SERVICE_TYPE: "<email service, for example, Outlook365>"
> EMAIL_NOTIFICATION_SMTP_OAUTH2_TOKEN_ACCESS_URL: "<provider token access url, for example, for Microsoft https://login.microsoftonline.com/common/oauth2/v2.0/token, for Google https://accounts.google.com/o/oauth2/token>"
> EMAIL_NOTIFICATION_SMTP_OAUTH2_EXPIRY_DATE_UNIX_TIMESTAMP: "<unix timestamp for the current accessToken, for example, 1681382246000>"
> EMAIL_NOTIFICATION_SMTP_OAUTH2_TLS_OPTION: "<optional, tls method if EMAIL_NOTIFICATION_SMTP_EMAIL_SERVICE_TYPE isn't set: 'tls' (default) to connect with implicit TLS, 'starttls' to upgrade the connection to TLS on the same port, or 'none' to connect without TLS>"
> ```
>
> Cognigy caches connections by default, and for OAuth2 connections, Cognigy also caches the refresh and access tokens. To update the refresh token or access token, create a [Snapshot](https://docs-classic.cognigy.com/ai/agents/deploy/snapshots.md).

> [tab] Basic Auth
>
> object:
>
> ```yaml theme={null}
> smtpEmailNotificationCredentials:
>   authType: "basic"
>   basic:
>     username: "<your email client's username>"
>     password: "<your email clientl's password>"
> ```
>
> variables:
>
> ```yaml theme={null}
> EMAIL_NOTIFICATION_SMTP_AUTH_TYPE: "basic"
> EMAIL_NOTIFICATION_SMTP_HOST: "<SMTP_HOST>"
> EMAIL_NOTIFICATION_SMTP_PORT: "<SMTP_PORT>"
> EMAIL_NOTIFICATION_SMTP_FROM: "<smtp-server>@domain.com"
> EMAIL_NOTIFICATION_SMTP_TLS_REQUIRED: "<required, tls method: 'tls' to connect with implicit TLS, 'starttls' to upgrade the connection to TLS on the same port (fails if the server doesn't support STARTTLS), or 'none' to connect without TLS>"
> ```

## Parameters

| Parameter | Description |
| - | - |
| Email Sender Name | The name displayed as the sender of the email. |
| Recipient | Comma-separated list of email addresses to send the email to. |
| Subject | The subject of the email. |
| Content | The content of the email. The field supports basic rich text editing. |

> [accordion] Store location of SMTP Request result
>
> | Option | Description |
> | - | - |
> | Don't store result | Default option. The result isn't stored. |
> | Input | The result is stored at a specified location in the **Input Key to store Result** field. |
> | Context | The result is stored at a specified location in the **Context Key to store Result** field. |

#### Stop on Error

If switched on, the Flow execution will halt in case the mail-sending fails.

> [accordion] Advanced
>
> | Parameter | Description |
> | - | - |
> | CC Email Addresses | The CC recipients of your email. |
> | BCC Email Addresses | The BCC recipients of your email. |
> | Email Priority | The priority of the email. |
> | Execute Request asynchronous | If switched on, the Flow execution continues directly after the Send Email Node has been triggered. If turned-off, the Flow execution waits until the email is sent. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.