Skip to main content

​
Overview

Money Tracker’s notification system keeps you informed about important events like new transactions, Gmail sync issues, and subscription updates. All notifications appear in the in-app notification panel with customizable preferences.

​
Notification Types

Money Tracker sends notifications for these events:

​
System Notifications

Gmail Connection Required

Category: SystemNotifies you when a Gmail account needs reconnection due to expired OAuth tokens.Action: Go to Settings to reconnect

Watch Renewal Needed

Category: SystemAlerts when a Gmail Watch is expiring soon (within 72 hours) and needs renewal.Action: Watches auto-renew, but you can manually trigger in Settings

Gmail Sync Error

Category: SystemNotifies about errors during Gmail synchronization or email processing.Action: Check Settings for connection status

​
Transaction Notifications

New Transaction Detected

Category: TransactionsSent when the AI successfully extracts a transaction from an email.Action: View transaction in Transactions page

Large Transaction Alert

Category: TransactionsAlerts for unusually large transactions (threshold configurable).Action: Review transaction details

​
Email Processing Notifications

Email Import Started

Category: ImportConfirms that a historical email import (seed) has started.Action: Monitor progress on Dashboard

Email Import Completed

Category: ImportNotifies when email import finishes, showing:
  • Total emails processed
  • Transactions found
  • Emails skipped
Action: View imported transactions

Email Import Failed

Category: ImportSent if email import encounters an error.Action: Retry import from Settings

​
Notification Panel

​
Opening Notifications

Click the bell icon in the top navigation bar to open the notification panel. The panel shows:
  • Unread count badge: Number of unread notifications
  • Notification list: Most recent notifications (up to 50)
  • Quick actions: Mark as read, archive, delete

​
Notification Card

Each notification displays:
  • Icon: Visual indicator of notification type
  • Title: Short description
  • Body: Detailed message
  • Timestamp: When the notification was created
  • Action button (optional): Quick link to relevant page
  • Importance badge: Normal, high, or urgent

​
Notification Actions

Click on a notification to mark it as read and reduce the unread count

​
Notification Preferences

Customize which notifications you receive in Settings.

​
Managing Preferences

1

Navigate to Settings

Click “Settings” in the sidebar
2

Scroll to Notification Preferences

Find the “Notification Preferences” section
3

Configure each notification type

For each notification type, you can:
  • Enable/Disable: Toggle to receive or block notifications
  • Mute: Silence notifications temporarily
4

Save automatically

Changes are saved instantly

​
Preference Options

Each notification type has two toggles:
Enabled: You’ll receive this notification typeDisabled: This notification type is completely blocked
Not Muted: Notifications show normally with unread badgesMuted: Notifications still appear in the panel but:
  • Don’t show unread badges
  • Don’t increment the unread count
  • Useful for less urgent notifications

​
Notification Categories

Preferences are organized by category:
  • System: Connection issues, watch renewals, sync errors
  • Transactions: New transactions, large amounts
  • Import: Email import status updates
  • Subscriptions (coming soon): Renewal reminders, price changes

​
Notification Importance

Notifications are tagged with importance levels:

Normal

Informational notificationsExamples: New transaction detected, import completed

High

Requires attentionExamples: Large transaction, watch expiring soon

Urgent

Requires immediate actionExamples: Gmail sync error, connection required

​
Filtering by Importance

You can filter notifications in the panel by importance level to focus on what matters most.

​
Notification Deduplication

Money Tracker prevents notification spam using deduplication:

​
How It Works

  • Each notification has a dedupe_key (e.g., gmail-sync-error-{userId}-{email})
  • If a notification with the same key exists within the deduplication window, a new one is not created
  • Default window: 180 minutes (3 hours)

​
Example

If Gmail sync fails multiple times in 3 hours:
  • First failure: Notification sent
  • Subsequent failures: No additional notifications for 3 hours
  • After 3 hours: New notification can be sent if the issue persists
This prevents your notification panel from being flooded with duplicate alerts.

​
Dashboard Tasks

In addition to notifications, the Dashboard shows “Smart Tasks” that require action:

Reconnect Gmail

Priority: HighOne or more Gmail accounts need reconnectionAction: Click to go to Settings

Renew Watch

Priority: MediumGmail Watches are expiring soon or expiredAction: Automatic renewal in progress

Email Import Processing

Priority: InfoShows real-time progress of email import:
  • Total emails fetched
  • Processed by AI
  • Transactions found
Action: Monitor progress

Email Import Failed

Priority: HighEmail import encountered an errorAction: Click to retry import

​
Task Priority Levels

  • High: Requires immediate attention (red badge)
  • Medium: Should be addressed soon (yellow badge)
  • Info: Informational, no action required (blue badge)

​
AI Activity Stats

The Dashboard also displays AI processing metrics:
  • Emails Processed by AI: Total count of emails analyzed
  • Transactions Found: Number of valid transactions extracted
  • Emails Skipped: Emails without transactions
These aren’t notifications but provide real-time visibility into AI activity.

​
Best Practices

Optimize your notification experience
  1. Enable critical notifications: Keep system and error notifications enabled
  2. Mute routine updates: Mute “New Transaction” if you check transactions regularly
  3. Review periodically: Check notification preferences monthly to adjust based on your needs
  4. Act on urgent notifications: Respond quickly to connection and sync error alerts
  5. Archive old notifications: Keep your notification panel clean by archiving read items

​
Troubleshooting

​
Not Receiving Notifications

  1. Check preferences: Ensure the notification type is enabled in Settings
  2. Verify events are occurring: For example, new transactions require new emails
  3. Check notification panel: Notifications are in-app only, not push notifications

​
Too Many Notifications

  1. Mute less important types: Use the mute toggle for routine notifications
  2. Adjust thresholds: Some notifications have configurable thresholds (coming soon)
  3. Archive read notifications: Clear out old notifications regularly

​
Missing Notification Actions

If action buttons don’t appear:
  • Not all notifications have actions (e.g., informational notifications)
  • Action paths are set by the system automatically
  • Click on the notification text to navigate to the relevant page

​
Future Enhancements

Planned notification features:
  • Email notifications (opt-in)
  • Push notifications (mobile)
  • Subscription renewal reminders
  • Budget alerts
  • Spending pattern insights
  • Configurable notification thresholds

Build docs developers (and LLMs) love

Get started for freeTalk to us