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

# Notifications

> Configure Zwiron alerts for job failures, schema changes, and agent status — in-app and email.

**Notifications** let you configure where Zwiron sends alerts for important events. You can receive them in the Zwiron app or by email today. [Webhooks](/platform/webhooks) for Slack and HTTP endpoints are coming soon.

***

## Notification events

| Event                   | Triggered when...                                      |
| ----------------------- | ------------------------------------------------------ |
| `job_completed`         | A pipeline run finishes successfully                   |
| `job_failed`            | A pipeline run ends with one or more failures          |
| `agent_offline`         | An agent has stopped sending heartbeats                |
| `schema_pending_review` | A schema change needs your review before the next sync |
| `schema_auto_applied`   | A safe schema change was applied automatically         |

***

## Notification channels

### In-app

In-app notifications appear in the bell icon at the top right of the Zwiron dashboard. All events are delivered in-app by default.

Click a notification to jump directly to the relevant job, agent, or schema proposal.

### Email

Enable email notifications per event type in **Settings** → **Notifications**. Zwiron sends the alert to the email address on your account.

### Webhooks (coming soon)

Outbound webhooks for Slack, PagerDuty, or custom HTTP endpoints are **not live yet**. See [Webhooks](/platform/webhooks) for the planned design. Until then, use in-app and email notifications.

***

## Configuring preferences

1. Go to **Settings** → **Notifications**
2. For each event type, toggle on or off:
   * **In-app** — always visible, can't be fully disabled
   * **Email** — sends to your account email

Webhook delivery is coming soon — see [Webhooks](/platform/webhooks).

***

## Notification per job vs. global

Notifications are currently global — you'll be notified for all jobs you have access to. Per-job filtering via webhooks is planned, not available yet.

***

## Reducing noise

If you receive too many `job_completed` notifications:

* Disable the `job_completed` email notification in preferences — keep only `job_failed` for actionable alerts
* Prefer in-app for low-priority events and email only for failures