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

# Notifications

> Choose where Aegis sends alerts (email, webhook, or Slack) and control exactly which governance events trigger a notification for your account.

Aegis can notify you when your agents trigger governance events, pending approvals, denied actions, rewrites, policy violations, anomalies, and budget thresholds. You choose which channels receive notifications and which events are worth a ping. Configure both from **Settings → Notifications**.

## Notification channels

Aegis supports three channels. Each channel can be toggled on or off independently.

<AccordionGroup>
  <Accordion title="Email" defaultOpen>
    Email notifications are always available and require no additional setup. When enabled, Aegis sends alerts to the email address associated with your account. You can update that address in **Settings → Profile**.

    Email is on by default. Toggle it off in **Settings → Notifications** if you prefer to receive alerts through another channel only.
  </Accordion>

  <Accordion title="Webhook">
    Webhook notifications deliver a signed JSON payload to an endpoint you control. Enabling this channel requires at least one webhook endpoint to be registered in **Settings → Webhooks**. If no endpoints are configured, toggling this on has no effect.

    For instructions on adding an endpoint and verifying payload signatures, see [Webhooks](/configuration/webhooks).
  </Accordion>

  <Accordion title="Slack">
    Slack integration is coming soon. When it becomes available, you will be able to connect a Slack workspace and forward alerts to a channel of your choice. The toggle is visible in **Settings → Notifications** but is not yet active.
  </Accordion>
</AccordionGroup>

## Event types

Aegis generates six categories of governance events. You can enable or disable each one independently, a channel only receives events that are toggled on.

| Event      | Label                  | Description                                                                                                |
| ---------- | ---------------------- | ---------------------------------------------------------------------------------------------------------- |
| `approval` | Approval requested     | An agent action was held in the approval queue and needs your review.                                      |
| `denied`   | Action denied          | A policy blocked an agent action from executing.                                                           |
| `rewrite`  | Action rewritten       | Aegis redirected an agent action to a safer path, for example, converting a direct push to a pull request. |
| `policy`   | Policy violated        | A configured governance rule fired on an agent action.                                                     |
| `anomaly`  | Session anomaly        | Aegis detected unusual agent behavior in a session.                                                        |
| `budget`   | Token budget threshold | Your token spend hit 75%, 90%, or 100% of your configured cap.                                             |

<Tip>
  Enable `approval` and `anomaly` at minimum. These are the two event types most likely to need immediate human attention.
</Tip>

## Configure channels and events

<Steps>
  <Step title="Open notification settings">
    In the Aegis dashboard, click **Settings** in the sidebar and select **Notifications**.
  </Step>

  <Step title="Enable the channels you want">
    In the **Channels** card, toggle on the delivery methods you want to use. To use Webhook, make sure you have at least one endpoint configured in **Settings → Webhooks** first.
  </Step>

  <Step title="Choose which events to receive">
    In the **Events** card, toggle each event type on or off. All six events are enabled by default. Disable any that are not relevant to your workflow.
  </Step>

  <Step title="Save your preferences">
    Click **Save preferences**. Your channel and event selections take effect immediately.
  </Step>
</Steps>

<Note>
  Channel and event settings are per-account. If you are using rooms with multiple members, each member configures their own notification preferences independently.
</Note>