Skip to main content
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
Notification preferences may also be available through Organization settings depending on your access level.

Notification Types

Task Notifications

EventDescription
Task StartedA task begins execution
Task CompletedA task finishes successfully
Task FailedA task encounters an error
Task WaitingA task needs user input

Agent Notifications

EventDescription
Agent ErrorAn agent encounters a critical error
Agent OfflineA worker disconnects
Execution LimitApproaching usage limits

System Notifications

EventDescription
Source Sync FailedData ingestion error
Security AlertDetected security issue
Scheduled Job FailedBackground 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 TypeSuggested 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