Email Configuration—create new or edit existing email configuration

2 minute read

Use this page to specify an email server to CloudBees Flow. If you do not create an email configuration, you cannot send email notifications to individuals or groups.

If you have multiple users or groups in remote locations that use a different mail server, create additional email configurations to accommodate those locations if they need to receive CloudBees Flow notifications.

To create a new email configuration

Enter information into the fields as follows:

Field Name Description


Unique name to identify the email configuration


(Optional) Plain text or HTML description for this object. If using HTML, you must surround your text with <html> …​ </html> tags. Allowable HTML tags are <a>, <b>, <br>, <div>, <dl>, <font>, <i>, <li>, <ol>, <p>, <pre>, <span>, <style>, <table>, <tc>, <td>, <th>, <tr>, and <ul>.

For example, the following HTML:

<p> <span style="font-family: Arial;"> <i>Note:</i> For more information about the <b>abc</b> object, see <a href="">\</a>. </span> </p>

renders as follows:

_Note:_ For more information about the *abc* object, see \

Mail Protocol

Specify either SSMTP or SMTP

Mail Host

Mail server name

Mail Port

(Optional) Port number for the mail server. Protocol software determines the default value ( 25 for SMTP and 465 for SSMTP). Specify a value for this argument when a nondefault port is used

Mail From

Email address used as the email sender address for CloudBees Flow notifications. This must be a fully-qualified email address (meaning that it must be of the form <name>@<domain> )

Mail Username

Individual name or a generic name such as qa-test

Mail Password

Password for the mail user name

Click Save after filling in all fields and then click the Test button to make sure your email configuration works. Then enter a destination email address into the Email Configuration Test popup that appears and click Send.

To edit an existing email configuration

Use the Access Control link at the top of the page to add or change permissions. You can modify any information or add new information. Click OK after completing your edits.