# Email Notifications

Email notifications are one of the quickest and easiest ways to get started with outbound notifications for Cisco Identity Intelligence.

## Setup

Setting up an email notification target requires the full administrator role.&#x20;

1. From the Integrations page, click Add Integration.

2. Select Add Email Target

3. Enter a target display name and description, if desired<br>

   <figure><img src="https://582105988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPSBzsjxd7KYg9DNVZ4l%2Fuploads%2FmzUnNRJxVaGDRM0gdaY3%2Fimage.png?alt=media&#x26;token=e372e090-4b8d-4d16-b2f7-3007e692eabf" alt="" width="563"><figcaption></figcaption></figure>

4. Choose the desired notification types to send to the notification target. A notification target can be used for one or multiple purposes. There are 3 options available:&#x20;

* Check Failures - Notification Target will be used to alert on check failures where the target is configured via the[ Check Settings ](https://docs.oort.io/understanding-check-failures/customizing-checks#notification-settings)
* Data Collection - Notification Target will be used to alert when errors are encountered when collecting data from the integrations or when an on-demand collection is finished (via "Collect Now" button for an integration)&#x20;
* Communication - Notification Target will be used as the "Reply-To" header value to the address in the configured notification target instead of a generic no-reply Identity Intelligence email address. Learn more in the [Mailgun](https://docs.oort.io/integrations/mailgun-integration) or [SendGrid](https://docs.oort.io/integrations/sendgrid-integration) documentation&#x20;

5. Enter the email address or distribution list, and any additional copy-to addresses. Use a comma-separated list to support multiple addresses

* **Select Checks Manually**: Check the box next to everything to check for. Use the search field to search for checks by name.\
  \
  When you're finished, click **Add Checks** and select the check box next to each check to add.
* **Select Checks by Category**: Check the box next to every Severity (or click **All** to select all severities), then check the box next to every **Topic** (or click **All** to select all topics).\
  \
  Example:

<figure><img src="https://582105988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPSBzsjxd7KYg9DNVZ4l%2Fuploads%2Fg91uTbelEwnBMPJhTVWZ%2F490095.jpg?alt=media&#x26;token=6a7d41f2-861c-4a7e-ac06-9b58c09ed7f7" alt=""><figcaption></figcaption></figure>

5. Select **Save**
6. To test the new target from the Integrations page, select the 3-dot menu for it on the right and select **Test Connectivity**<br>

   <figure><img src="https://582105988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPSBzsjxd7KYg9DNVZ4l%2Fuploads%2FINhitOqJcoDzYeztBclY%2Fimage.png?alt=media&#x26;token=b9172c0d-fce0-4c40-b2c9-9bf2535264da" alt=""><figcaption></figcaption></figure>

## Add the Email Target to One or More Checks

1. With the new email notification target in place, navigate to the Checks page.
2. Select the **Add +** button in the column and select one or more Checks where you would like email notifications for new failing users.  You can also test the functionality from this point <br>

   <figure><img src="https://582105988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPSBzsjxd7KYg9DNVZ4l%2Fuploads%2FMsukzCwe93KwIFxoo7OV%2Fimage.png?alt=media&#x26;token=8e176cfa-a288-4b7b-9d3b-1eac830b4dfb" alt=""><figcaption></figcaption></figure>

## Notification Format and Frequency

Email notifications differ slightly from chat app notifications like [slack-notification-integration](https://docs.oort.io/integrations/slack-notification-integration "mention") and [microsoft-teams-notification-integration](https://docs.oort.io/integrations/microsoft-teams-notification-integration "mention") in the following way:

1. By default, **one** email is sent per check per day, with a summary report of up to 20 users. &#x20;
2. If more than 20 new users failed that particular check in a 24 hr period, then use the "See Report" link at the bottom of the email to view the list of users in the Identity Intelligence dashboard
