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

# Notifications

> Configure notification preferences and alert channels

Notification settings control how and when Kubiya alerts you about important events. Configure channels, event types, and delivery preferences.

## Access

Access notifications through:

* **Notification bell** icon in the header bar
* **User menu** > notification preferences

<Note>
  Notification preferences may also be available through Organization settings depending on your access level.
</Note>

## Notification Types

### Task Notifications

| Event              | Description                  |
| ------------------ | ---------------------------- |
| **Task Started**   | A task begins execution      |
| **Task Completed** | A task finishes successfully |
| **Task Failed**    | A task encounters an error   |
| **Task Waiting**   | A task needs user input      |

### Agent Notifications

| Event               | Description                          |
| ------------------- | ------------------------------------ |
| **Agent Error**     | An agent encounters a critical error |
| **Agent Offline**   | A worker disconnects                 |
| **Execution Limit** | Approaching usage limits             |

### System Notifications

| Event                    | Description             |
| ------------------------ | ----------------------- |
| **Source Sync Failed**   | Data ingestion error    |
| **Security Alert**       | Detected security issue |
| **Scheduled Job Failed** | Background job error    |

## Notification Channels

### In-App Notifications

* Click the **bell icon** in the header to view notifications
* Unread count shows as a badge
* Mark as read individually or all at once

### Email Notifications

Configure email delivery:

1. Enable email notifications
2. Set frequency (immediate, daily digest, weekly digest)
3. Select which events trigger emails

### Slack Notifications

Connect Slack for team-wide alerts:

1. Click **Connect Slack**
2. Authorize the Kubiya app
3. Select channels for different notification types
4. Configure mention preferences

## Configuring Preferences

### Per-Event Settings

For each event type, configure:

* **Enabled/Disabled** - Whether to receive this notification
* **Channel** - Where to deliver (in-app, email, Slack)
* **Priority** - Normal or High (affects delivery timing)

### Quiet Hours

Set times when non-critical notifications are held:

1. Enable quiet hours
2. Set start and end times
3. Select timezone
4. Critical notifications still deliver immediately

### Filtering

Filter notifications by:

* Project
* Agent or Team
* Environment
* Severity level

## Notification Center

Access the notification center from the bell icon:

### View Notifications

* **All** - Complete notification history
* **Unread** - Notifications not yet viewed
* **Mentions** - Notifications where you're mentioned

### Actions

* **Mark as Read** - Clear the unread indicator
* **Mark All as Read** - Clear all unread
* **View Details** - Open related resource
* **Delete** - Remove from history

## Best Practices

### Reduce Noise

1. Disable notifications for routine events
2. Use digests instead of immediate delivery
3. Set up filters for specific projects or environments

### Critical Alerts

For important events:

1. Enable multiple channels (in-app + Slack)
2. Set high priority
3. Exclude from quiet hours

### Team Coordination

For team-wide visibility:

1. Send to shared Slack channels
2. Use project-based filtering
3. Configure different channels for different teams

## Slack Integration

### Connecting Slack

1. Go to Settings > Notifications
2. Click **Connect Slack**
3. Select your Slack workspace
4. Authorize permissions
5. Choose default channels

### Channel Configuration

Map notification types to channels:

| Notification Type | Suggested Channel     |
| ----------------- | --------------------- |
| Task failures     | #kubiya-alerts        |
| Security issues   | #security-alerts      |
| General updates   | #kubiya-notifications |

### Mentions

Configure who to @mention for critical alerts:

* Specific users
* User groups
* Channel (@channel, @here)

## Troubleshooting

### Not Receiving Notifications

1. Check notification settings are enabled
2. Verify your email is correct
3. Check spam/junk folders
4. Ensure Slack app has channel access

### Too Many Notifications

1. Reduce event types enabled
2. Switch to daily digests
3. Add filters by project/environment
4. Set up quiet hours

## Related Pages

* **[Task Kanban](/web-interface/task-kanban)** - View tasks that generate notifications
* **[Connect Slack](/infrastructure/connect-slack)** - Detailed Slack integration
* **[Background Jobs](/core-concepts/background-jobs)** - Job-related notifications