Skip to content
Katalogue Docs

Email Notifications

Enable email notifications to let Katalogue send send emails. Emails can be sent either through the Microsoft Graph API or through a custom SMTP server.

The emails that Katalogue can send when this feature is enabled are:

  • Schema change notification to selected recipients in a datasource sync task whenever the sync task detects changes to schema-related attributes.
  • System emails (currently only task run failures) to one or more email addresses
  • Welcome email to new users with login instructions, a link to Katalogue and for local users, an auto-generated, temporary password that must be changed on first login.
  • Password reset email with link to reset a user’s password (applies to local users only)
  • Changed password email to the user to notify whenever its password has been changed (applies to local users only)
  • Test email to test your email server configuration

Microsoft Graph API

Section titled “Microsoft Graph API”

Configure Katalogue to send emails through the Microsoft Graph API in Azure:

  1. Enable and configure Azure OpenID Connect Authentication for Katalogue
  2. On the “API permissions” pane in the Microsoft Entra Id app registration for Katalogue:
  3. Add permission Microsoft Graph -> Application permissions -> Mail -> Mail.Send. Note that this need an “admin consent” to become effective.
  4. Get a Microsoft Entra Id email account with a license that provide the email account with an inbox.
  5. Enter the email address in the From field in Settings -> Notifications
  6. Make sure that firewalls etc allow connection from Katalogue.
  7. Click the Send Test Email button to send a test email to the email address of the user you are currently logged in as.

Note that there is a limit on the number of emails you can send each day through Azure. As of 2025-04-22 this limit is 10 000. More info on how emailing through Azure is implemented here: https://learn.microsoft.com/en-us/graph/outlook-mail-concept-overview

Custom SMTP Server

Section titled “Custom SMTP Server”
  1. Specify Host, Port, From address and optional login credentials (Username and Password) for the SMTP server.
  2. Make sure that firewalls etc allow connection to the SMTP server from Katalogue.
  3. Click the Send Test Email button to send a test email to the email address of the user you are currently logged in as.