New: API Reference docs are live — integrate Cleanlist enrichment into your apps. View API docs →
Guides
Notification Settings

Notification Settings

Cleanlist sends notifications for important events like low credit balance, enrichment completions, and payment updates. Customize what you receive and how.

📸

Screenshot needed: The notification bell dropdown in the portal navbar — showing a few notification items (e.g., "Enrichment Complete", "Low Credits Warning") with read/unread indicators, timestamps, and the "Mark all as read" button at the bottom.

Notification Types

TypePriorityDescription
Low CreditsHighYour credit balance dropped below your threshold
Credits DepletedUrgentNo credits remaining
Enrichment CompleteMediumA bulk enrichment or playbook step finished
Enrichment FailedHighAn enrichment task encountered errors
Subscription RenewedLowYour plan auto-renewed successfully
Payment FailedUrgentPayment couldn't be processed
New FeatureLowProduct updates and new capabilities

Notification Preferences

Customize your settings in the portal:

SettingDefaultDescription
Email on Low CreditsOnReceive an email when credits drop below threshold
Credit Threshold20%Percentage of credits remaining that triggers the alert
In-App NotificationsOnShow notifications in the portal notification bell
Daily SummaryOffDaily email digest of activity
Weekly SummaryOffWeekly email digest of activity

How to Configure

  1. Click the notification bell icon in the portal header
  2. Click Notification Settings at the bottom of the dropdown
  3. Toggle preferences on/off
  4. Adjust the credit threshold percentage
  5. Changes save automatically
📸

Screenshot needed: The notification preferences/settings panel — showing toggle switches for each setting (email on low credits, in-app notifications, daily summary, weekly summary) and the credit threshold input.

In-App Notifications

The notification bell in the portal header shows:

  • Unread count badge (red circle)
  • Last 50 notifications sorted by time
  • Each notification shows: icon, title, message, timestamp, read/unread status
  • Mark all as read and Clear all actions at the bottom

Notification Actions

Some notifications include action buttons:

  • Low Credits → "Add Credits" (links to billing)
  • Enrichment Complete → "View List" (links to the lead list)
  • Payment Failed → "Update Payment" (links to billing portal)

Low Credit Alerts

The low credit alert system:

  1. Checks your balance against your threshold after every credit deduction
  2. Baseline: 500 credits (so 20% threshold = alert at 100 credits remaining)
  3. Sends email to all org members who have email alerts enabled
  4. Creates in-app notification
  5. Won't send duplicate alerts within 24 hours

Learn More