Notifications Not Working

Not Getting Notifications?

Follow these steps to diagnose and fix notification issues.

Step 1: Wait for Notification Delay

Most common reason for "no activity": You just created the rule or triggered an event, and the notification hasn't arrived yet.

Notifications are not instant. They typically arrive within 1 minute, but can take up to 5 minutes (sometimes longer) due to:

• Notion webhook batching (aggregates events)
• Network latency
• Discord API processing

What to do: Wait 5 minutes after creating/updating a page in Notion before troubleshooting further.

Step 2: Check Notifications Page

Go to the Notifications page to check your rules for issues:

1. Rule toggle: Verify toggle is ON (blue). Disabled rules will not send any notifications.
2. Error badges: Look for red "Missing Permissions" badge on rules
3. Activity history: Check "Last sent" timestamp or "Last attempt failed" messages to see if notifications are being sent

What to do next:

• "Missing Permissions" badge showing → Go to Step 4 to fix permissions
• No error badges, no activity history → Most likely notification delay (Step 1), then check rule configuration and database sharing (Steps 5-6)
• Recent activity showing, but nothing in Discord → Contact support (see "Get Help" section below) - this indicates a delivery issue

Step 3: Check Notion Connection

If you see a "Notion connection expired" message or errors like "API token is invalid," your Notion connection was revoked or removed.

What to do:

1. Go to Settings → Notion Workspace → Disconnect
2. Click Connect and re-authorize Notion

Step 4: Check Discord Permissions

NotiCord needs specific permissions to post in Discord channels.

Required Permissions

The bot needs these permissions in each channel:

• View Channel - To see the channel exists
• Send Messages - To post notifications
• Embed Links - To format task cards
• Attach Files - To include attachments in notifications

Fix Permission Issues

Method 1: Channel-specific (Recommended)

Right-click channel → Edit Channel → Permissions → Add NotiCord bot → Enable: View Channel, Send Messages, Embed Links, Attach Files.

Method 2: Server-wide

Server Settings → Roles → NotiCord → Enable: Send Messages, Embed Links, Attach Files.

After fixing: Refresh the Notifications page, verify "Missing Permissions" badge is gone, test with a Notion update.

Step 5: Verify Rule Configuration

If notifications still haven't arrived after 5+ minutes, check your rule settings:

Common configuration issues:

1. Event selection mismatch:

   • Make sure Created and/or Updated are selected for what you're testing
   • For page rules, Created only works when subpages are included (Direct children or All descendants)

2. Update types (Updated events only):

   • Make sure at least one update type is enabled
   • Page rules: Title edits require Title; body edits require Content edits
   • Database rules: If you selected properties, the changed property must be one of them

3. Status filter (database rules with a Status property, Updated only):

   • If you set a status filter (e.g., only "Done"), notifications only appear when status changes to that value
   • Try removing the filter to see all status changes

Quick fix: Create a minimal test rule with "Created", then test by creating a new page/subpage.

Step 6: Check Notion Access

If notifications still don't work, the database or page might not be shared with NotiCord.

Follow the access guide: Give NotiCord Access in Notion.

Get Help

Still stuck? Join our Discord community (fastest) or email support@noticord.com.