--- title: "Email and SMTP in Decisions" slug: "email-and-smtp-in-decisions" tags: ["email", "smtp", "email server"] updated: 2025-06-23T15:47:37Z published: 2025-06-23T15:47:37Z --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt > Use this file to discover all available pages before exploring further. # Email and SMTP in Decisions ## Overview Decisions provide basic email functionality, allowing users to send an email from the application to a user. However, emails sent using the default settings will be filtered out. To resolve this issue, an**SMTP server** or relay for email handling must be configured while [installing](https://documentation.decisions.com/v9/docs/installation-guide?highlight=Email%20Server%2C%20Encryption%20Keys%2C%20and%20File%20Storage) the application or by updating the **Settings.xml** file after successfully completing the installation. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/app-email_service.png) --- ## Default Email Address Decisions use a default email address (admin@decicions.com) to send system-related emails for communication. If your SMTP (Simple Mail Transfer Protocol) provider does not allow sending emails through the decisions.com domain, the email notifications may not be delivered successfully. Admin users can update the default email address(admin@decisions.com) from the [Portal Settings](https://documentation.decisions.com/v9/docs/portal-settings#-portal-settings). 1. Navigate to the System > Settings > Portal Settings. In the search bar, search for "Default Email".![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-08_14h41_26.png) 2. Disable **Use Default Email Address in Notifications** located under Notifications Settings. 3. Update the **Default EmailAddress** located under the Portal Settings that is compatible with your SMTP provider's settings. 4. Save and Close the settings box. --- ## Direct Mail Connection Note:Direct mail connection is only used for testing and troubleshooting purposes and is not recommended for production servers. Direct Mail Connection is the default enabled method that sends emails with any valid email in the "To" and "From" input fields for email steps. Emails sent using this method are sorted out by spam and junk filters, and this is not a reliable source for sending emails. --- ## Modifying SMTP Settings via Settings.xml Decisions can be configured to use an SMTP Server****or relay by changing the **** setting to **false** in the installer settings or [Settings.xml](/v9/docs/system-settings-overview-settings-xml) file. If **ByPassSMTP****Server**is **Enabled**(set to true), a validation error will display in the Studio advising against bypassing SMTP Settings in a production environment. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-08_14h43_10.png) 1. Navigate to**C:\Program Files\Decisions\Decisions Server** and open **Settings.xml**. 2. Navigate to the SMTP settings under and update the settings with the proper configuration for the associated email server. - For Office365 SMTP settings, navigate [here](https://docs.microsoft.com/en-us/exchange/mail-flow-best-practices/how-to-set-up-a-multifunction-device-or-application-to-send-email-using-office-3). - For Gmail SMTP settings, navigate [here](https://support.google.com/a/answer/176600?hl=en). With Google depreciating Less Secure App settings for Google accounts, users must create [App Passwords](https://support.google.com/accounts/answer/185833). - For Outlook SMTP settings, navigate [here](https://support.office.com/en-us/article/pop-imap-and-smtp-settings-for-outlook-com-d088b986-291d-42b8-9564-9c414e2aa040). | Setting Name | Description | | --- | --- | | ByPassSMTPServer | If this option is enabled (set to true), any email sent will ignore the configured SMTP settings. | | ServerAddress | This setting specifies the address of the SMTP server used to send emails from the application. | | ClientDomain | The client's domain name used for identifying the sender's domain during the SMTP communication. | | Port | This setting determines the port number through which the application communicates with the SMTP server. Common values include 25 (unencrypted), 465 (implicit SSL), and 587 (explicit SSL/TLS). | | RequiresAuthentication | When set to "true," this indicates that the SMTP server requires authentication using credentials to authorize sending emails. | | UseOauth | When set to "true," the application uses OAuth for authentication, which is a more secure method than sending a plain username and password. | | OauthTokenId | This setting holds the unique identifier (token) associated with the OAuth authentication process. | | Username | The username used for authentication when sending emails via the SMTP server. | | Password | The corresponding password associated with the provided username for SMTP server authentication. | | UseSSL | If enabled, the application establishes a secure connection to the SMTP server using SSL/TLS encryption. | | UseImplicitSSL | When set to "true," the application uses implicit SSL, which means the encryption is established right from the beginning of the connection. | | SkipCertificateRevocationCheck | If set to "true," the application skips checking for certificate revocation. However, this might reduce security if not necessary. | 3. Save and close the file. 4. [Restart](https://documentation.decisions.com/v9/docs/restart-decisions-application) the Decisions application. Once the external SMTP settings are configured, Flow steps that trigger email events (i.e. [Send Emai](https://documentation.decisions.com/step-library/docs/send-email)l step or assigned Forms) will use these settings to handle outbound mail. --- ## SMTP Settings in Steps Step Article:For a detailed configuration of the Send Email step, refer to the article [Send Email](https://documentation.decisions.com/step-library/docs/send-email). Only one SMTP server can be configured in the settings. If an email event must be triggered for different SMTP servers, certain Flow steps can be configured to bypass and use SMTP settings defined on the step itself. This can be found in the**SMTP Settings**category for the step. Unchecking**Use Default SMTP Settings** will allow a custom SMTP server to be used for the step. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-23_11h45_40.png) --- For further information on Flows, visit the [Decisions Forum](https://community.decisions.com/categories/Flows).