> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kadoa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

> Get notified when workflow events occur

Notifications alert you when workflows complete, fail, or detect data changes. You can receive them via email, webhooks, or WebSockets.

## Configuration Levels

Configure notifications at two levels:

* **Workspace-Level**: Default notifications for all workflows unless overridden
* **Workflow-Level**: Apply to a specific workflow and override workspace settings

## Event Types

### Events You Can Subscribe To

| Event                                    | Dashboard label     | Description                                                              |
| ---------------------------------------- | ------------------- | ------------------------------------------------------------------------ |
| `workflow_finished`                      | Workflow finished   | Workflow completed successfully                                          |
| `workflow_failed` / `workflow_recovered` | Workflow health     | Workflow failed or recovered ([details below](#workflow-health))         |
| `workflow_data_change`                   | Data changes        | Data changes detected ([Change Detection Rules](/docs/change-detection)) |
| `workflow_validation_anomaly_change`     | Data quality issues | New data quality issues                                                  |

### Workflow Health

Subscribing to **Workflow health** gives you failure and recovery notifications for your workflows.

* **Failure**: When a run fails, you receive a `workflow_failed` event with the error reason and a suggested action.
* **Recovery**: When the workflow succeeds after a failure, you receive a `workflow_recovered` event.

If you also subscribe to **Workflow finished**, recovery notifications are replaced by the `workflow_finished` event for scheduled workflows, so you won't receive both for the same run.
For real-time monitors, `workflow_recovered` is always sent when the monitor comes back online, regardless of other subscriptions.

### System Events

These events are automatic and can't be configured:

| Event                       | Description                                                                           |
| --------------------------- | ------------------------------------------------------------------------------------- |
| `workflow_sample_finished`  | Sample data ready. Sent to workflow author only via **email**.                        |
| `workflow_export_completed` | Data exported to [cloud storage](/docs/integrations/cloud-storage). Fires on failure. |

## Notification Channels

| Channel       | Description                                                                           |
| ------------- | ------------------------------------------------------------------------------------- |
| **Email**     | Sent to your account email or custom recipients ([details](/docs/integrations/email)) |
| **Slack**     | Send notifications to Slack channels ([details](/docs/integrations/slack))            |
| **Webhook**   | For custom integrations ([details](/docs/integrations/webhooks))                      |
| **WebSocket** | Real-time data streaming ([details](/docs/integrations/websockets))                   |

<Info>
  Create a channel before subscribing to events. One channel can receive multiple event types.
</Info>

<Note>
  Payload structure varies by channel. Please see each channel's documentation for format details and examples.
</Note>

## Data Change Configuration

For `workflow_data_change` events, filter what triggers notifications:

* **Fields**: Select specific fields to track (all by default)
* **Conditions**: Filter notifications based on criteria
* **Change Type**: Select what type of change you want to track
  * **Updated**: Additions, modifications, and removals
  * **Added**: New records only
  * **Removed**: Deleted records only

<Info>
  The `workflow_data_change` is triggered after the data changes are detected according to [Change Detection Rules](/docs/change-detection).
</Info>

## Templates

Notifications can be included as part of a [template](/docs/templates). When a workflow is linked to a template that includes notifications, the notification settings are managed through the template.

## Managing Notifications

* [UI Docs](/docs/ui/notifications)
* [SDK Docs](/docs/sdk/notifications/overview)

Do you need help in setting up notifications? Contact [support team](https://www.kadoa.com/contact?type=support).