Skip to main content
Updated in 2026.3

​
Description

In Cognigy.AI 2026.4.0, the OAuth2 authentication method for the Send SMTP Email Node was deprecated. The removal of this authentication method is scheduled for the release of Cognigy.AI 2026.16.0. To avoid disruptions in AI Agents using OAuth2 in this Node, migrate to the OAuth2 Client Credentials authentication method before the removal date.
Use the Send SMTP Email Node to send an email via an SMTP connection to a recipient.

​
Parameters

Some email providers, such as Gmail, require you to configure your mail account to allow sending mail via SMTP before you can use it.
ParameterDescription
Email ServiceSelect the Email Provider of the address you want to send from. If yours is not listed, you can select Other SMTP Service to do a manual configuration.
SMTP SettingsDepending on which Email Service selected above, you need to either enter your login credentials for that service or for the full SMTP connection information in case you selected the “Other SMTP Service” option.
Recipient TO Email AddressesComma-separated list of email addresses to send the email to.
Email SubjectThe subject of the email.
Email ContentThe content of the email. The field supports basic rich text editing.
You can use one of the following authentication methods:
By default, the No Attachment option is selected.
Attachment TypeDescription
From URLYou can specify a public Web URL or a data URL. The linked File will then be attached to that mail. You can also pick a custom filename for the attached file.
From Text ContentYou can define a text that should be sent as an attachment.
From Base64 StringYou can define Base64-encoded data that should be attached.
Custom Content AttachmentIf you need to send text content with a specific MIME-Type, allowing you to define an own MIME-Type.
From Pregenerated MIME NodeAllows to send a fully customized attachment body manually.
OptionDescription
Don’t store resultDefault option. The result isn’t stored.
InputThe result is stored at a specified location in the Input Key to store Result field.
ContextThe 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.
ParameterDescription
Custom From Email AddressThis email address will be displayed in the “from” field (sender’s address).
CC Email AddressesThe CC recipients of your email.
BCC Email AddressesThe BCC recipients of your email.
Reply To AddressThis email address is the target for receiving mails when recipients reply to your email.
Define custom text Email ContentIf your content contains non-text content, you can provide a customized text-only version of the mail content here for improved compatibility with limited devices.
Email PriorityYou can use this option to set your priority to high, normal (default), or low.
Execute Request asynchronousIf switched on, the flow execution will continue directly after the Send Email Node was triggered. If turned-off, flow execution will wait until the email is sent.

​
Example

This example shows how to configure OAuth2 Client Credentials with Microsoft 365 SMTP using Microsoft Entra ID.
Before starting, ensure the following:
  • Your Microsoft Entra account must have one of the following roles:
    • Application Developer (minimum).
    • Cloud Application Administrator or Global Administrator (recommended).
  • The mailbox that will send emails must:
    • Be hosted in Microsoft 365 or Exchange Online.
    • Have SMTP AUTH activated.
  1. Log in to the Microsoft Entra admin center.
  2. In the left sidebar, select Entra ID > App registrations.
  3. Click New registration. On the Register an application page, enter a name, for example, Cognigy SMTP Integration.
  4. In the Supported account types section, select Accounts in any organizational directory (Any Azure AD directory - Multitenant). Follow Microsoft best practices for multitenant applications, especially regarding security and permission scope.
  5. Leave Redirect URI empty, this field isn’t required for OAuth2 Client Credentials. Click Register.
  6. After the registration, the Application Overview page appears. Copy and securely store:
    • Application (client) ID.
    • Directory (tenant) ID.
    You will need these IDs later for the Send SMTP Email Node.
  1. In the created application, go to Manage > Certificates & secrets.
  2. Click New client secret.
  3. Enter the required information:
  • Description – for example, Cognigy SMTP Secret.
  • Expiration – specify the date according to your company’s security policy.
  1. Click Add. Copy the appeared secret value and store it securely. You will need this secret later for the Send SMTP Email Node.
  1. Add the SMTP.SendAsApp permission to your Microsoft Entra application. Ensure admin consent is granted where required.
  2. Register a Service Principal for the your application.
  1. In the Send SMTP Email Node, select Microsoft 365 as the email service.
  2. For the Authentication Method, select OAuth2 Client Credentials and click + to create a new connection.
  3. In the connection configuration, fill in the required fields:
  • Connection Name — enter a unique name for the connection.
  • Client ID — enter the application (Client) ID from Microsoft Entra.
  • Client Secret — enter the secret value created under Certificates & Secrets from Microsoft Entra.
  • Scope — enter https://outlook.office365.com/.default
  • Token Endpoint URL — enter https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token and replace {tenant_id} with your Directory (tenant) ID from Microsoft Entra.
  • User — enter the email address of the sender mailbox. Make sure SMTP AUTH is activated for the user, and the user is granted the SMTP.SendAsApp permission.
  1. Click Create to save the connection, then fill in the required fields for the email configuration, such as Recipient TO Email Addresses, Email Subject, and Email Content.
IssuePossible CauseSolution
General errorsTypos in the configuration, expired or missing secrets.Double-check the scope, the token endpoint, the client secret, and ensure you are using the same mailbox as the OAuth2 credentials.
Invalid login or authentication failedCustom FROM Email Address is set, OAuth credentials mismatch, disabled SMTP AUTH, or wrong token endpoint or scope.Leave Custom FROM Email Address empty, ensure credentials match the sender mailbox, enable SMTP AUTH, and verify the scope (https://outlook.office365.com/.default) and the token endpoint (https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token).
401 UnauthorizedYour application lacks SMTP.SendAsApp, Admin consent isn’t granted, the Service Principal is missing, or the SendAs permission is missing.Grant the SMTP.SendAsApp permission, provide admin consent, ensure the Service Principal exists in Exchange, and assign the SendAs permission for the mailbox.
535 Authentication failedThe mailbox SMTP AUTH is deactivated.Activate SMTP AUTH in Microsoft 365 Admin Center > Mailbox > SMTP AUTH.
Multitenant app issues or token acquisition failedApp not multi-tenant, the Service Principal missing, or incorrect client ID, tenant ID, or client secret.Ensure the app is multitenant, the Service Principal exists, and verify the client ID, tenant ID, and Client Secret used in Cognigy.AI.