Email Server Properties

For Workflow to send e-mails, you must configure at least one e-mail server using the Email Server Properties dialog box.

You can access this dialog box from the following places:

To add or modify an e-mail server

In the Email Server Properties dialog box, next to Email Server Name, give the server a unique display name. This name is necessary to distinguish between multiple e-mail servers.

Under SMTP Settings choose an Authentication type from the dropdown.

Basic Authentication

  1. Define your e-mail server and port. Only specify a port if you need to use a non-standard e-mail port. (The standard port is 25, which will be used unless you specify a different port.)
  2. Optional: Select Use SSL if you want to secure the connection between the Workflow Server and e-mail server.
  3. Configure your authentication settings.
    • Select Use default authentication to authenticate using the same account as the Workflow Server service.
    • Clear Use default authentication to specify a user name and password used to authenticate to the e-mail server. (This authentication may be optional because some e-mail servers do not require a user name or password.)
  4. Under Sender Address, specify an e-mail address. Emails sent from this server will be sent from this address.
  5. Example: Bob configures his e-mail server's sender address as "workflow@company.com." Every time a workflow sends an e-mail, it will come from this address. Bob monitors this account periodically to see if employees have replied to e-mails sent from Workflow.

  6. Optional: Provide a default subject for e-mails sent from this e-mail server.
  7. Optional: In the Validation section, test the settings you configured by providing an e-mail address to send a test e-mail to and clicking Test.
  8. Select the Enabled checkbox to enable the e-mail server, or clear the Enabled checkbox if you want to disable the e-mail server. You may have multiple e-mail servers and want one disabled while you configure another one.
  9. When finished, click OK.
  10. Optional: If you accessed this dialog box from the Workflow Configuration Manager or the Workflow Administration Console, the Email Server Manager dialog box will appear. You can select an existing e-mail server and click Edit to change it, click Delete to remove it, or double-click the green check or red X in the Enabled column to toggle its status between enabled and disabled.
  11. Optional: If you accessed this dialog box from the Workflow Designer, the Referenced Object Manager will appear and you can select an existing e-mail server and click Edit to change it.
  12. Click Close to exit the Email Server Manager or Referenced Object Manager.

Microsoft 365 OAuth 2.0

  1. Ensure your email administrator has completed the Prerequisites for Microsoft 365 OAuth 2.0 Configuration.
  2. Provide the Application (client) ID, Tenant ID and Client secret, which can be found by following the Prerequisites for Microsoft 365 OAuth 2.0 Configuration instructions.

    Note: The API server will be automatically filled.

  3. Provide the email address from Microsoft tenant in Sender address.
  4. Optional: Provide a pre-set subject line in the Default subject field. This subject line will automatically appears when composing a new email, allowing users to quickly start writing without having to manually type a subject line every time.
  5. In the Validation section, provide an email address that can receive email and click Test button to test the email settings.
  6. Select the Enabled checkbox to enable the email server configuration.
  7. When finished, click OK.

Gmail OAuth 2.0

  1. Ensure your email administrator has completed the Prerequisites for Gmail OAuth 2.0 Configuration.
  2. Provide the Application (client) ID and Client secret which can be found by following the Prerequisites for Gmail OAuth 2.0 Configuration instructions.

    Note: The API server will be automatically filled.

  3. Click the Authorize button to authorize with Google.
  4. Optional: Provide a pre-set subject line in the Default subject field. This subject line will automatically appears when composing a new email, allowing users to quickly start writing without having to manually type a subject line every time.
  5. Provide the email address from Gmail in Sender address.
  6. In the Validation section, provide an email address that can receive email and click Test button to test the email settings.
  7. Select the Enabled checkbox to enable the email server configuration.
  8. When finished, click OK.

Assigning a different e-mail server to multiple activities in a workflow

Example: The Human Resources Department has a new e-mail server that Workflow should use to send e-mails. Instead of individually updating each e-mail activity, you can update all the activities at once with the Reassign option.