# Notifications Reference Guide

Immuta offers real-time notifications to keep you informed of events from your data consumers and data stewards. These notifications provide timely updates on requests requiring your determination and actions occurring within your data marketplace. The following notification options are available:

* In-app
* [Slack notifications](#slack-notifications)
* [Microsoft Teams notifications](#microsoft-teams-notifications)
* [Email notifications](#email-notifications)

Notifications provide an automated solution to receive notifications about key actions and events within the Request app. Messages that require action also include links that direct the recipient into Immuta to see more information and address the request.

See the list of notifications Immuta will send in the [Notification types reference guide](https://documentation.immuta.com/saas/request/notifications/reference-guides/notifications-reference-guide/notifications).

## Example notification

This is an example of the notification for an access request sent to data stewards:

> User **John Doe** has [requested access](https://app.immutacloud.com/marketplace/) to data product **Your Data Product**, for which you are a Steward. Please make a determination on that request.

## Slack notifications

{% hint style="info" %}
**Public preview**: The Slack notifications feature is available to all accounts. Contact your Immuta representative for details.
{% endhint %}

Slack notifications must be [manually set up by an admin](https://documentation.immuta.com/saas/request/how-to-guides/manage-slack-notifications#set-up-slack-notifications-for-your-tenant). The Slack notifications will then be sent to the Slack user with the email that matches the Immuta user's profile page, which is automatically populated by the [configured IAM](https://documentation.immuta.com/saas/configuration/application-configuration/how-to-guides/config-builder-guide#use-existing-identity-access-manager).

### What permissions does the Immuta Slack app require in my workspace?

When the Immuta Slack app is configured in your Slack workspace, it will require the following Slack permissions. The app is preconfigured to get all of these permissions when you install it in your workspace.

**Actions the Immuta app can take**

* [chat:write](https://api.slack.com/scopes/chat:write) - Send messages as @Immuta
* [im:write](https://api.slack.com/scopes/im:write) - Start direct messages with people
* [reactions:write](https://docs.slack.dev/reference/scopes/reactions.write) - Add and edit emoji reactions

**Information the Immuta app can view**

* [im:read](https://api.slack.com/scopes/im:read) - View basic information about direct messages that the Immuta app has been added to
* [users:read](https://api.slack.com/scopes/users:read) - View people in a workspace
* [users:read.email](https://api.slack.com/scopes/users:read.email) - View email addresses of people in a workspace
* [reactions:read](https://docs.slack.dev/reference/scopes/reactions.read) - View emoji reactions and their associated content in channels and conversations that the Immuta app has been added to

## Microsoft Teams notifications

{% hint style="info" %}
**Public preview**: The Microsoft Teams notifications feature is available to all accounts. Contact your Immuta representative for details.
{% endhint %}

Microsoft Teams notifications must be [manually set up by an admin](https://documentation.immuta.com/saas/request/how-to-guides/manage-microsoft-teams-notifications#set-up-microsoft-teams-notifications-for-your-tenant). Then, each user who wants Microsoft Teams notifications must [install the Immuta Teams app](https://documentation.immuta.com/saas/request/how-to-guides/manage-microsoft-teams-notifications#enable-microsoft-teams-notifications-for-yourself).

### What permissions does the Immuta Microsoft Teams app require in my workspace?

When the Immuta Microsoft Teams app is configured in your Microsoft Teams workspace, it will require the following Microsoft Teams permissions. The app is preconfigured to get all of these permissions when you install it in your workspace.

* Receive messages and data that you provide to it.
* Send you messages and notifications.
* Access to your profile information, such as your name, email address, company name, and preferred language.

## Email notifications

Email notifications are enabled by default, but they can be [globally disabled](https://documentation.immuta.com/saas/request/how-to-guides/manage-email-notifications#email-configuration). Each user can also [control their email preferences individually](https://documentation.immuta.com/saas/request/how-to-guides/manage-email-notifications#email-configuration). The notifications will be sent to the email found on the user's profile page, which is automatically populated by the [configured IAM](https://documentation.immuta.com/saas/configuration/application-configuration/how-to-guides/config-builder-guide#use-existing-identity-access-manager).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.immuta.com/saas/request/notifications/reference-guides/notifications-reference-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
