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

# Notifications

> Configure alerts for renewals, compliance changes, shadow IT detection, and integration health across email, Slack, and webhooks — routed to the right team.

Layer's notification system lets you route alerts to the right people through the channels they already use. You can configure notification channels and rules in **Settings → Notifications**.

## Channels

Layer supports three notification channels:

| Channel     | Configuration                                        |
| ----------- | ---------------------------------------------------- |
| **Email**   | A list of recipient email addresses                  |
| **Slack**   | A Slack incoming webhook URL                         |
| **Webhook** | A URL and a shared secret for signature verification |

You can create multiple channels of each type — for example, separate Slack channels for IT alerts and finance alerts.

### Webhook security

Webhook notifications include an `x-webhook-signature` header containing an HMAC-SHA256 signature of the request body, computed using your shared secret. Verify this signature on your end to confirm the notification came from Layer.

## Notification rules

Rules connect events to channels. Each rule specifies:

* **Event type** — what triggers the notification.
* **Channel** — where the notification is delivered.
* **Enabled/disabled** — toggle rules on or off without deleting them.

You can create multiple rules for the same event to send notifications to different channels simultaneously.

## Event types

| Event type                  | Description                                                        |
| --------------------------- | ------------------------------------------------------------------ |
| **Renewal approaching**     | A contract renewal date is within your configured lookahead window |
| **Shadow app detected**     | A new unmanaged application was discovered                         |
| **Control failing**         | A compliance control dropped below the passing threshold           |
| **Control passing**         | A previously failing compliance control is now passing             |
| **Evidence expiring**       | Compliance evidence is approaching its expiration date             |
| **Access review due**       | An access review campaign deadline is approaching                  |
| **Questionnaire completed** | A vendor security questionnaire was completed                      |
| **Monitor alert**           | An integration health monitor detected an issue                    |
| **License harvest ping**    | An unused license candidate was identified for reclamation         |

<Tip>
  Start with the events that matter most to your team. You can always add more rules later without affecting existing notifications.
</Tip>

## Set up notifications

<Steps>
  <Step title="Create a channel">
    Go to **Settings → Notifications** and click **Add channel**. Choose the channel type (email, Slack, or webhook) and provide the required configuration.
  </Step>

  <Step title="Add notification rules">
    For each event you want to be notified about, click **Add rule**, select the event type and the channel, then save.
  </Step>

  <Step title="Test the channel">
    Use the **Send test** button to verify your channel is configured correctly before relying on it for production alerts.
  </Step>
</Steps>

<Note>
  Email notifications require the **Starter** plan or above. Slack and webhook channels require the **Growth** plan or above.
</Note>