Configure Email Settings

IMPORTANT: Starting at 23.13, Cityworks is changing how it sends emails. Instead of an SMTP server authenticated with basic authentication, a Microsoft Graph API is used to send emails starting with Cityworks 23.13. This change enhances security and aligns with modern Microsoft standards, since Microsoft is deprecating basic authentication for SMTP. The following things must be completed to support this change:

  • The Microsoft Admin must create a new app registration in the Azure Portal or Entra.
  • Under the Microsoft.Graph permissions, the app needs the Mail.Send application permission (not delegated).
  • Give the permission tenant-wide permission.
  • In the app's Certificates & Secrets section, create a new client secret.
  • From the app's overview in Azure Portal or Entra, copy the Application (client) ID and Directory (tenant) ID.
  • In Oauth 2 Clients, a new Microsoft Azure client needs to be created. Enter the Application (client) ID, Directory (tenant) ID, and client secret for the new client. See Configure Single Sign-on in the Single Sign-on 23 Guide for more information.

NOTE: Admin automatically saves the changes you make. A notification pops up at the bottom to verify changes have been saved.