Notification Settings

The Workflow Scheduler can send email notifications when a scheduled execution completes or fails. Notifications keep you informed about pipeline health without requiring you to log in and check execution history manually.

Configuring Notifications

Notification settings are available in the workflow creation form and in the edit panel for existing workflows. You will find them in the Notifications section, below the schedule configuration.

Notification settings section showing email address input and checkboxes for notify on success and notify on failure

The settings are:

  • Recipient email addresses — enter one or more email addresses to receive notifications. Separate multiple addresses with commas. These can be individual inboxes or a team distribution list.
  • Notify on success — send a notification each time the workflow completes successfully.
  • Notify on failure — send a notification each time the workflow fails (including when all retries are exhausted).

You can enable one or both notification types independently.

Failure Notifications

Failure notifications are strongly recommended for any workflow running in production. When an execution fails, the notification email includes:

  • The workflow name and the project it ran against.
  • The date and time of the failed execution.
  • Which pipeline step failed.
  • The error message from that step.
  • A link to the execution history entry for full details.

Without failure notifications, a broken workflow can silently miss runs for days before anyone notices. If your pipeline feeds a downstream system or report, set up failure notifications so the right person is alerted immediately.

If retries are configured, the failure notification is only sent after all retry attempts are exhausted — not after each individual failed attempt. This avoids notification noise for transient errors that resolve on retry.

Success Notifications

Success notifications are useful when:

  • A downstream process (such as a report refresh or a data consumer) needs to know that fresh output is available.
  • You are monitoring a new or recently changed workflow and want to confirm each run completed as expected.
  • Compliance or audit requirements call for a log of successful pipeline executions delivered to an email record.

For stable, long-running workflows, you may prefer to disable success notifications to reduce inbox noise — failures are what require action. For high-frequency workflows (multiple times per day), receiving a success notification on every run can become disruptive.

Updating Notification Settings

You can update notification settings at any time by editing the workflow. Changes take effect on the next execution. You can add or remove recipients, and toggle success or failure notifications on or off, without affecting the schedule or pipeline step configuration.

Notifications require the MatchLogic server to have outbound email configured. If you are not receiving notifications, verify with your system administrator that the email service is enabled and that the sending address is not being filtered as spam.