Create the Microsoft Azure Client

The Microsoft Azure Client must be created to sent emails through a Microsoft Graph API.

PREREQUISITES:

  • You must be a Cityworks administrator to access the Oauth 2 Clients page.
  1. From the home page, click the Admin tab and click OAuth2 Clients.
  2. Click Add record to add a client.
  3. Enter a Name for the client.
  4. Select Microsoft Azure as the Type from the drop-down list.
  5. Click Add.

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.
  1. From the app's overview in Azure Portal or Entra, copy the Application (client) ID and paste it in the Id field.
  2. In the app's Certificates & Secrets section, create a new client secret.
  3. Enter this new client secret in the Secret field.
  4. From the app's overview in Azure Portal or Entra, copy the Directory (tenant) ID and paste in the Tenant Id field.
  5. The Type displays the type selected when the client was made, but can be changed using the drop-down list.
  6. Select the Active check box to mark the client as active. Only one email client can be active at a time.
  7. Click Save.

Once this is done, see Configure Email Settings to finish configuring your email settings.