> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seocrawler.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Email Notifications
> Configure email alerts for crawl events and issues
## Overview
Email notifications keep you informed about your website's health without logging into the dashboard. Configure alerts for completed crawls, new issues, SSL expiration warnings, and more.
## Notification Types
### Crawl Notifications
| Notification | Description | When Sent |
| -------------------- | --------------------------------- | ----------------------------------- |
| **Crawl Complete** | Summary of crawl results | After each crawl finishes |
| **New Issues Found** | Alert when new problems detected | If crawl finds new issues |
| **Issues Resolved** | Confirmation when issues fixed | If previously broken links now work |
| **Crawl Failed** | Alert when crawl encounters error | If crawl cannot complete |
### SSL Notifications
| Notification | Description | When Sent |
| ------------------ | ----------------------- | ------------------------- |
| **30-Day Warning** | Early warning | 30 days before expiration |
| **14-Day Warning** | Action needed soon | 14 days before expiration |
| **7-Day Warning** | Critical warning | 7 days before expiration |
| **Expired Alert** | Certificate has expired | Upon expiration |
### Account Notifications
| Notification | Description | When Sent |
| ----------------- | --------------------------------- | ------------------- |
| **Usage Warning** | Approaching plan limits | At 80% of limits |
| **Limit Reached** | Plan limit hit | When limit exceeded |
| **Billing** | Payment receipts, failed payments | On billing events |
## Configuring Notifications
### Account-Level Settings
Configure default notifications for your account:
Navigate to **Settings** → **Notifications**.
Choose which notifications to receive:
```
Notification Preferences
─────────────────────────────────────────
Crawl Notifications
☑ Crawl completed
☑ New issues found
☑ Issues resolved
☑ Crawl failed
SSL Notifications
☑ 30-day expiration warning
☑ 14-day expiration warning
☑ 7-day expiration warning (critical)
☑ Certificate expired
Account Notifications
☑ Usage warnings
☑ Billing receipts
```
Add additional email addresses to receive notifications:
* Primary account email (always receives)
* Additional team members
* Distribution lists
Click **Save Preferences**.
### Domain-Level Settings
Override account defaults for specific domains:
Navigate to the domain → **Settings** → **Notifications**.
Toggle **Custom Notifications** to ON.
Set domain-specific preferences:
* Different recipients
* Different notification types
* Custom schedules
## Email Formats
### Crawl Complete Email
```
Subject: ✓ Crawl Complete: example.com - Score: 78/100
─────────────────────────────────────────────────────────
CRAWL COMPLETE
example.com
─────────────────────────────────────────────────────────
Health Score: 78/100 (Good) ▲ +5 from last crawl
Summary:
• Pages Checked: 847
• Broken Links: 12 (3 new)
• Redirects: 45
• SEO Issues: 34
Top Issues:
1. /products/old-widget - 404 Not Found (8 pages affected)
2. /blog/draft-post - 404 Not Found (5 pages affected)
3. Missing H1 on /services
[View Full Report] [Start New Crawl]
─────────────────────────────────────────────────────────
Crawl completed: Dec 2, 2024 at 3:04 PM
Duration: 4 minutes, 23 seconds
```
### New Issues Alert
```
Subject: ⚠ 3 New Issues Found: example.com
─────────────────────────────────────────────────────────
NEW ISSUES DETECTED
example.com
─────────────────────────────────────────────────────────
3 new issues found during the latest crawl:
🔴 CRITICAL (1)
• /api/endpoint returning 500 error
Found on: /developers page
🟠 WARNING (2)
• /team/john-smith - 404 Not Found
Found on: /about, /team
• Missing meta description on /new-product
[View All Issues] [Ignore These]
─────────────────────────────────────────────────────────
```
### SSL Expiring Warning
```
Subject: 🔒 SSL Certificate Expiring in 7 Days: example.com
─────────────────────────────────────────────────────────
SSL CERTIFICATE WARNING
example.com
─────────────────────────────────────────────────────────
Your SSL certificate will expire in 7 days!
Certificate Details:
• Domain: example.com
• Issuer: Let's Encrypt
• Expires: December 9, 2024 at 12:00 AM UTC
• Days Remaining: 7
⚠ After expiration, visitors will see security warnings
and may be unable to access your site.
Action Required:
1. Renew your SSL certificate
2. Install the new certificate on your server
3. Verify installation with SEO Crawler
[Check SSL Status] [Renew Guide]
─────────────────────────────────────────────────────────
```
## Digest Options
Instead of individual emails, receive consolidated digests:
### Daily Digest
Receive a single daily email summarizing all activity:
```
Daily Digest Settings
─────────────────────────────────────────
☑ Enable daily digest
Time: 9:00 AM ▼ (in your timezone)
Include:
☑ Crawl summaries
☑ New issues
☑ Resolved issues
☑ SSL status
```
### Weekly Report
Comprehensive weekly summary:
```
Weekly Report Settings
─────────────────────────────────────────
☑ Enable weekly report
Day: Monday ▼
Time: 9:00 AM ▼
Include:
☑ Health score trends
☑ Issue summary
☑ Top recommendations
☑ Comparison to last week
```
## Quiet Hours
Prevent non-critical notifications during specified hours:
```
Quiet Hours
─────────────────────────────────────────
☑ Enable quiet hours
Quiet period: 10:00 PM to 7:00 AM ▼
During quiet hours:
● Hold notifications until quiet hours end
○ Send immediately (ignore quiet hours)
Exception: Always send critical alerts immediately
☑ SSL expired
☑ Site down (5xx errors on homepage)
```
## Managing Recipients
### Adding Recipients
Add team members to receive notifications:
Go to **Settings** → **Notifications** → **Recipients**.
Enter the email address and select notification types:
| Recipient | Notifications |
| ----------------------------------------- | -------------------------- |
| [dev@company.com](mailto:dev@company.com) | Crawl failures, SSL alerts |
| [seo@company.com](mailto:seo@company.com) | New issues, crawl complete |
| [ops@company.com](mailto:ops@company.com) | SSL only |
Recipient receives verification email and must confirm.
### Per-Domain Recipients
Set different recipients for different domains:
```
Domain Recipients
─────────────────────────────────────────
example.com
• john@company.com (all notifications)
• dev@company.com (failures only)
client-site.com
• sarah@company.com (all notifications)
• client@client.com (weekly digest only)
```
## Email Delivery
### Delivery Status
Check email delivery in **Settings** → **Notifications** → **Delivery Log**:
```
Email Delivery Log
═══════════════════════════════════════════════════════════
Recipient Subject Status
─────────────────────────────────────────────────────────────
john@company.com Crawl Complete: example.com ✓ Delivered
dev@company.com SSL Warning: example.com ✓ Delivered
spam@test.com Crawl Complete: test.com ✗ Bounced
```
### Troubleshooting Delivery
1. Check spam/junk folder
2. Add `notifications@seocrawler.app` to contacts
3. Verify email address in settings
4. Check delivery log for bounces
5. Ensure notification type is enabled
1. Mark our emails as "Not Spam"
2. Add our domain to safe senders
3. Check with your IT about email filtering
4. Consider using a personal email for testing
1. Enable daily digest mode
2. Reduce notification types
3. Set up quiet hours
4. Use domain-level filtering
## Agency Email Settings
Agency plan users can customize email branding and sender.
### White-Label Emails
Configure branded emails for client notifications:
| Setting | Description |
| -------------- | ---------------------------- |
| **From Name** | Your company name |
| **From Email** | Requires custom domain setup |
| **Logo** | Your logo in email header |
| **Colors** | Match your brand colors |
| **Footer** | Custom footer text |
See [Custom Domains](/agency/custom-domains) for email domain setup.
### Client Notifications
Send notifications directly to clients:
Go to **Clients** → Select client → **Notifications**.
Add client email addresses.
Choose what clients receive:
* Weekly reports (recommended)
* Crawl summaries
* Critical alerts only
Toggle on white-label branding for these emails.
## API Integration
Manage notifications via API:
### Get Notification Settings
```bash theme={null}
curl -X GET \
"https://api.seocrawler.app/v1/settings/notifications" \
-H "Authorization: Bearer YOUR_API_KEY"
```
### Update Settings
```bash theme={null}
curl -X PATCH \
"https://api.seocrawler.app/v1/settings/notifications" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"crawl_complete": true,
"new_issues": true,
"ssl_warnings": ["30_day", "14_day", "7_day"],
"daily_digest": false
}'
```
## Best Practices
Daily digests reduce inbox clutter while keeping you informed.
Avoid notification fatigue by setting quiet hours for non-critical alerts.
Send different notification types to appropriate team members.
Periodically review and adjust notification settings as needs change.
## Next Steps
Set up real-time webhook notifications.
Configure automated report delivery.