> For the complete documentation index, see [llms.txt](https://documentation.immuta.com/saas/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.immuta.com/saas/govern/detect-your-data/notifications/reference-guides/notification-events.md).

# Notification Events

{% hint style="info" %}
Immuta offers webhooks for events in both the Request app and the Govern app. For details about the available webhooks and setup instructions for the Request app, see the [Notifications section](/saas/request/notifications/reference-guides/notifications-reference-guide/notifications.md).
{% endhint %}

Application admins can configure webhooks that are triggered by events that happen in the system (such as when data sources or projects are created), but any user can configure webhooks that are triggered by access requests and activity notifications.

## Events <a href="#events" id="events"></a>

The following event types can be used to configure a webhook.

| Type                                       | Triggers                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ALL_NOTIFICATIONS`                        | Configures the webhook to be triggered by any event type.                                                                                                                                                                                                                                                                                                                                                                                          |
| `acknowledgedAccess`                       | A project member acknowledges the purposes on a project.                                                                                                                                                                                                                                                                                                                                                                                           |
| `addedToProject`                           | A data source is added to a project.                                                                                                                                                                                                                                                                                                                                                                                                               |
| `apiKeyRevoked`                            | A user's API key is revoked.                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `attributeAdded`                           | An attribute is added to a group or user.                                                                                                                                                                                                                                                                                                                                                                                                          |
| `attributeRemoved`                         | An attribute is removed from a group or user.                                                                                                                                                                                                                                                                                                                                                                                                      |
| `attributeUpdated`                         | Attributes for a group or user are updated.                                                                                                                                                                                                                                                                                                                                                                                                        |
| `automaticDomainAssignmentFailure`         | Automatically assigning a data source to a domain using a tag has failed.                                                                                                                                                                                                                                                                                                                                                                          |
| `bulkJobStatus`                            | A bulk action is completed (whether success/failure).                                                                                                                                                                                                                                                                                                                                                                                              |
| `certificationRequired`                    | A global policy that requires certification by the data source owner is applied to a data source.                                                                                                                                                                                                                                                                                                                                                  |
| `collectionCreated`                        | A domain is created.                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `collectionDataSourceAdded`                | A data source is added to a domain.                                                                                                                                                                                                                                                                                                                                                                                                                |
| `collectionDataSourceRemoved`              | A data source is removed from a domain.                                                                                                                                                                                                                                                                                                                                                                                                            |
| `collectionDeleted`                        | A domain is deleted.                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `collectionPermissionGranted`              | A domain permission has been assigned to a user.                                                                                                                                                                                                                                                                                                                                                                                                   |
| `collectionPermissionRevoked`              | A domain permission has been removed from a user.                                                                                                                                                                                                                                                                                                                                                                                                  |
| `collectionUpdated`                        | A domain was updated.                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `conflictingGlobalPolicies`                | Global policies are applied to the same column on a data source.                                                                                                                                                                                                                                                                                                                                                                                   |
| `dataSourceExpired`                        | A data source that was configured to expire has expired.                                                                                                                                                                                                                                                                                                                                                                                           |
| `dataSourceExpiring`                       | A data source that was configured to expire expires tomorrow.                                                                                                                                                                                                                                                                                                                                                                                      |
| `dataSourceUpdated`                        | A data source is updated.                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `deletedDatasourceRemovedFromProject`      | A data source has been deleted and then removed from a project.                                                                                                                                                                                                                                                                                                                                                                                    |
| `expiredDatasourceRemovedFromProject`      | A data source that has expired and been deleted is removed from a project.                                                                                                                                                                                                                                                                                                                                                                         |
| `firstQuery`                               | A data source is queried for the first time through Immuta.                                                                                                                                                                                                                                                                                                                                                                                        |
| `frameworkCreated`                         | A classification framework was created.                                                                                                                                                                                                                                                                                                                                                                                                            |
| `frameworkDeleted`                         | A classification framework was deleted.                                                                                                                                                                                                                                                                                                                                                                                                            |
| `frameworkUpdated`                         | A classification framework was updated.                                                                                                                                                                                                                                                                                                                                                                                                            |
| `globalPolicyCreated`                      | A global policy is created.                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `globalPolicyDeleted`                      | A global policy is deleted.                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `globalPolicyDisabled`                     | A global policy is disabled.                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `globalPolicyUpdated`                      | A global policy is updated.                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `groupUserAdded`                           | A user is added to a group.                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `groupUserDeleted`                         | A user is removed from a group.                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `healthCheckFailed`                        | A health check runs and returns not healthy.                                                                                                                                                                                                                                                                                                                                                                                                       |
| `healthCheckResolved`                      | A health check runs and returns healthy.                                                                                                                                                                                                                                                                                                                                                                                                           |
| `modelAccessApproved`                      | [A user's subscription request is approved for a data source or project.](#user-content-fn-1)[^1]                                                                                                                                                                                                                                                                                                                                                  |
| `modelAccessDenied`                        | [A user's subscription request is denied for a data source or project.](#user-content-fn-1)[^1]                                                                                                                                                                                                                                                                                                                                                    |
| `modelAccessRequested`                     | [A user requests to subscribe to a data source or project.](#user-content-fn-1)[^1]                                                                                                                                                                                                                                                                                                                                                                |
| `modelAccessRevoked`                       | [A user's subscription membership is revoked for a data source or project.](#user-content-fn-1)[^1]                                                                                                                                                                                                                                                                                                                                                |
| `modelAccessUpdated`                       | [A user's access level is updated for a data source or project.](#user-content-fn-1)[^1]                                                                                                                                                                                                                                                                                                                                                           |
| `modelCopied`                              | A data source or project is copied.                                                                                                                                                                                                                                                                                                                                                                                                                |
| `modelCreated`                             | A data source or project is created.                                                                                                                                                                                                                                                                                                                                                                                                               |
| `modelDeleted`                             | A data source or project is deleted.                                                                                                                                                                                                                                                                                                                                                                                                               |
| `modelTagAdded`                            | A tag is added to a data source or a data source column.                                                                                                                                                                                                                                                                                                                                                                                           |
| `modelTagRemoved`                          | A tag is removed from a data source or a data source column.                                                                                                                                                                                                                                                                                                                                                                                       |
| `modelUserAdded`                           | A user is added to a data source.                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `modelUserDeleted`                         | A user is removed from a data source.                                                                                                                                                                                                                                                                                                                                                                                                              |
| `modelUserJoined`                          | A user joins a data source that they are already allowed to join.                                                                                                                                                                                                                                                                                                                                                                                  |
| `nativeIntegrationValidationFailed`        | A validation test for an enabled integration has failed.                                                                                                                                                                                                                                                                                                                                                                                           |
| `permissionsUpdated`                       | A user's permissions are updated.                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `policyCertificationExpired`               | A policy certification on a data source has expired.                                                                                                                                                                                                                                                                                                                                                                                               |
| `policyUpdated`                            | A data source's policies have been updated by a user or global policy. Policy updates are triggered for many reasons, including when a data source is created, a user updates them, a global policy changed, tags are added to a data source or column, the data source columns changed, a fingerprint is recomputed (only available for Snowflake data sources), an external catalog modifies tags on a linked data source, or a policy disabled. |
| `projectDisabled`                          | A project is disabled.                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `projectEqualizationMemberNotInCompliance` | A member of an equalized project is out of compliance.                                                                                                                                                                                                                                                                                                                                                                                             |
| `projectEqualizationToggled`               | Project equalization is toggled on or off.                                                                                                                                                                                                                                                                                                                                                                                                         |
| `projectUpdated`                           | A project is updated.                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `purposeCreated`                           | A purpose is created.                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `purposeDeleted`                           | A purpose is deleted.                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `purposeUpdated`                           | A purpose is updated.                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `queryCanceled`                            | A running query is canceled due to a change on a data source.                                                                                                                                                                                                                                                                                                                                                                                      |
| `removedFromProject`                       | A data source is removed from a project.                                                                                                                                                                                                                                                                                                                                                                                                           |
| `switchedCurrentProject`                   | A user switches their current project.                                                                                                                                                                                                                                                                                                                                                                                                             |
| `tagCreated`                               | A tag is created.                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `tagDeleted`                               | A tag is deleted.                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `tagUpdated`                               | A tag is updated.                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `taskDeleted`                              | An outstanding data source task is deleted without validation.                                                                                                                                                                                                                                                                                                                                                                                     |
| `taskValidated`                            | An outstanding data source task is validated.                                                                                                                                                                                                                                                                                                                                                                                                      |
| `userCloned`                               | A user is cloned.                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `userCreated`                              | A user or group is created.                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `userDeleted`                              | A user or group is deleted.                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `userDisabled`                             | A user is disabled.                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `userEnabled`                              | A user is enabled.                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `userMigrated`                             | A user is migrated from an old IAM to a new IAM.                                                                                                                                                                                                                                                                                                                                                                                                   |
| `usernameUpdated`                          | A user's name is updated.                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `userUpdated`                              | A group is updated.                                                                                                                                                                                                                                                                                                                                                                                                                                |

[^1]: This event can only occur within a subscription with approval policy workflow, which has been deprecated.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://documentation.immuta.com/saas/govern/detect-your-data/notifications/reference-guides/notification-events.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.