You can set up Connect to AD to send notifications when a user is created, updated, or disabled. You can also receive notifications when the synchronization process either completes successfully or encounters an error. You have complete control over when notifications are sent and their contents.

Connect to AD can send a notification for each of these event types:

  • On Insert Notification - A notification is sent for each inserted user.

  • On Update Notification - A notification is sent for each updated user.

  • On Disable Notification - A notification is sent for each disabled user.

  • On Complete Notification - A notification is sent when the sync process completes.

All notifications are delivered via email (an SMTP service is required).

Messages will remain in the system for 50 days, starting when they are successfully delivered. After that period, they will be deleted.

Each event type includes values for the basic parts of an email message, which are fully configurable via expressions and conditions.

  • Send Condition - The condition for sending the notification.

  • From (Sender) - The sender's email address.

  • To (Recipient) - The email addresses of people who will receive the email

  • CC (Carbon Copy) - The email addresses of people who will receive the email but who are not expected to reply

  • Subject - A short description of the message topic. 

  • Body - The contents of the message.

  • Body Type - The content-type of the body (plain or HTML) 

Here is an example of an On Insert use-case and how to implement it:

When a new user is inserted into Active Directory, Send an email notification to the user's personal email address and include the following:

  • The notification email must be sent from a specific email address

  • The notification must be sent to their personal email address (as stored in UKG) and not their work email address

  • Send a copy to their assigned manager

  • Send a copy to the IT department

  • Reference the department they will be joining

  • Reference their manager's name

  • Provide default network credentials (include their user name and default  password) 

1.  Add an On Insert notification

2. Modify the From expression, set it to:



This states that the insert notification will be sent from from the email address. 

3. Modify the To expression, set it to


This states that the notification should be sent to the employee's personal email address as it is stored in UKG. Note that we reference the alternate email address because it stores their personal email address field, not the primary one reserved for their work email address. 

4. Modify the CC expression set it to:

Employment.SupervisorEmailAddress + ";"

This states to send a copy of the notification to their manager, as well as the IT department ( 

5. Modify the Subject expression set it to:

'Welcome to the ' + OrgLevel1.Description + ' department.'

This references the department they will be joining in the subject line. 

5. Modify the Body expression, set it to:

'Please reach out to your manger ' + Employment.SupervisorFirstName + " " + Employment.SupervisorLastName + ' for any questions (included on this email).' + Environment.NewLine + "Your network credentials are: " + Environment.NewLine + "User name: " + User.UserLogonName + Environment.NewLine + "Password: " + User.password


This references their manager and also provides their network credentials (user name and default password). 

6. Modify the Body Type expression, set it to:


This states that the body content type is plain and not html.

7. Save the On Insert notification

This setup should send an email notification when a user is inserted in Active Directory.

Was this article helpful?



Please sign in to leave a comment.