githubEdit

Notifications

View and amend notifications for your CIPP App

Configure notifications from CIPP.

CIPP provides alert notifications for Tenants and CIPP actions, sent as one combined table in an email or webhook body.

  • Alert Configuration creates notifications regarding changes within a tenant. See that help page for more information on managing those alerts.

  • CIPP Alerts relate to changes initiated via the CIPP platform.

Available CIPP Alerts

Under the "Choose which logs you would like to receive alerts from" you will be able to select what you would like to receive alerts from CIPP actions. A sample of the alerts is listed below:

  • New Accounts created via CIPP

  • Removed Accounts via CIPP

  • New Applications added via CIPP

  • New Policies added via CIPP

  • New Standards added via CIPP

  • Removed Standards via CIPP

  • Token Refresh Events

Sending Methods

E-mail

Enter as many email addresses as you need, separated by a comma.

Email will be sent from the service account used for the Setup Wizard.

circle-exclamation
circle-info

Sent Items Notification emails do not save to the CIPP account's Sent Items folder.

Webhook

Enter a webhook URL. Data is formatted based on the receiving server:

Service
Format

webhook.office.com (see deprecation note)

A basic HTML formatted table.

slack.com

A separate markdown-formatted message for each alert.

discord.com

A basic HTML formatted table.

All other services

JSON array of data values. Method is POST

circle-exclamation
circle-info

Custom Webhook Formatting: Need something different for your webhook? Can you write PowerShell? Submit a PR on this repo: CIPP-APIarrow-up-right.

Log and Severity Settings

Log Alerts

Selecting one or more of these log alert types will send an alert to your configured methods if that event occurs in the Logbook.

Alert Severity

Selecting these severities will send any Logbook entry that matches the severity level to your configured methods. See the Logbook Severity chart on the Logbook docs page on the different severities and what they cover.

circle-info

"Alert" is selected by default. Without this selected any alerts you set up via Alert Configuration will not be sent.

Notification Setting Options

Setting
Description

Receive one email per tenant

Toggling on this option will separate emailed alerts by tenant as opposed to sending all matching log entries as a single alert.

Send notifications to configured integration(s)

This will enable notifications to be sent to the integration(s) you have configured.

Send Test Alert

You are able to select to send a test alert. Select which options you want to include in your test before clicking Confirm.


Feature Requests / Ideas

We value your feedback and ideas. Please raise any feature requestsarrow-up-right on GitHub.

Last updated

Was this helpful?