Contact us at 408.675.5020 or

Home Page

Knowledge Base Search     Advanced

How to Configure SMTP Settings for Approval Emails

Article ID: 1589
Last updated: 19 Oct, 2017


The approval feature in the create profile uses SMTP services to send templated emails from ServiceControl to the selected approval group. Approval Emails require that SMTP be setup and configured on the host server.

When someone uses ServiceControl to create a new user with the Approvals feature enabled, the Workflow Engine is responsible for sending out those approval emails using SMTP settings configured against the Workflow Engine web application. The SMTP settings set in the ServiceControl Administration panel will not be applied to the Workflow Engine.


If an approval group has been assigned to a workflow Create Profile and SMTP settings are not configured, or if SMTP settings are misconfigured, the Workflow Engine will report an Object Reference not set to an instance of an Object exception.

Resolution: Configure SMTP for the Workflow Engine

To resolve this issue set the SMTP settings in IIS Manager on the ServiceControl server hosting the Workflow Engine:

  1. In IIS Manager navigate to Sites.

  2. Click on Omni.WorkflowEngine.

  3. Double-Click SMTP E-Mail.

  4. Set each of the fields to the correct information for your SMTP environment.

  5. Click specify credentials > Click the set... button.

  6. Enter the credentials for a valid user and click ok.

  7. Log out of ServiceControl.

Upon logging into ServiceControl you should now be able to create users that require approvals without seeing an error message.

This article was:   Helpful | Not helpful Report an issue

Article ID: 1589
Last updated: 19 Oct, 2017
Revision: 5
Views: 314
Comments: 0
print  Print email  Email to friend share  Share pool  Add to pool comment  Add comment
Also read
item How to Upgrade ServiceControl to Identity Maestro
item How to Migrate Identity Maestro to a New Windows Server

Prev     Next
How To: Enhance Username Uniqueness Checking During User Creation       Reenable Remote PowerShell Support After Upgrading Exchange 2013...