Skip to main content

Email Notifications

Set up reliable email notifications for instant alerts about your infrastructure events. Email notifications are available on all AstroPulse plans and provide a universal communication method for your team.

Add an email channel​

Register the email address that should receive notifications. Use whichever surface fits how you work; all three configure the same channel and validate the address.

Console​

  1. Navigate to Settings → Notifications in the AstroPulse Console
  2. Click Add Channel
  3. Select Email as the channel type
  4. Enter your email address
  5. Click Create Channel

CLI​

astroctl notifications integrations configure --channel email --email admin@company.com

See the astroctl notifications integrations configure reference for every flag.

Nova​

Ask Nova in plain language to add an email address as a notification channel.

"Add ops@example.com as an email notification channel."

Subscribe to topics​

Choose which events reach your email. Available topics include Cluster Pipeline (infrastructure lifecycle) and Application Pipeline (deployment and application updates).

Console​

  1. Click Add Subscription
  2. Choose the events you want to monitor
  3. Select Email as your notification channel
  4. Click Subscribe

CLI​

astroctl notifications subscriptions upsert --topic cluster-pipeline --channels email

See the astroctl notifications subscriptions upsert reference for the full topic list and flags.

Nova​

Tell Nova which events you want delivered by email and it creates the matching subscriptions.

"Email me cluster pipeline notifications."

📧 Features​

Built-in Validation​

  • Automatic email address format validation
  • Real-time feedback on invalid addresses
  • Prevents configuration errors

Reliable Delivery​

  • Enterprise-grade email infrastructure
  • Delivery confirmation tracking
  • Retry mechanisms for failed deliveries

Universal Compatibility​

  • Works with any email provider
  • No special setup required
  • Compatible with email filters and rules

⚙️ Configuration Options​

  1. Click Add Channel again
  2. Enter a different email address
  3. Create separate subscriptions for different topics

Channel Management​

  • Enable/Disable: Toggle email notifications on/off without losing configuration
  • Edit Settings: Update email addresses as needed
  • Delete Channel: Remove email channels you no longer need

📋 Best Practices​

Email Organization​

  • Use team emails: Set up shared team inboxes for collaborative monitoring
  • Filter by topics: Create email rules to organize notifications by event type
  • Avoid personal emails: Use dedicated monitoring email addresses for production alerts

Subscription Strategy​

  • Start selective: Begin with critical events only
  • Expand gradually: Add more topics as you understand the notification volume
  • Review regularly: Remove subscriptions for events you no longer monitor

Deliverability​

  • Whitelist domains: Add @astropulse.io to your email whitelist
  • Check spam folders: Initial notifications might be filtered
  • Monitor delivery: Ensure notifications are reaching your inbox

🛠 Troubleshooting​

Not Receiving Emails​

Check Channel Status:

  1. Go to Settings → Notifications
  2. Verify your email channel is enabled (green status)
  3. Check that your subscription is active

Verify Email Address:

  1. Ensure the email address is spelled correctly
  2. Check for typos in the domain name
  3. Confirm the email account is active

Check Email Filters:

  1. Look in your spam/junk folder
  2. Check email rules that might be filtering messages
  3. Search for emails from noreply@astropulse.io

Whitelist AstroPulse: Add these to your email whitelist:

  • @astropulse.io
  • noreply@astropulse.io
  • notifications@astropulse.io

Email Validation Errors​

"Invalid email format":

  • Ensure proper email format: user@domain.com
  • Remove extra spaces before/after the email
  • Check for special characters that might not be supported

"Email already in use":

  • Each email can only be used once per organization
  • Use a different email address or update the existing channel

Delivery Delays​

Email notifications are typically delivered within:

  • Immediate: < 30 seconds for critical alerts
  • Standard: 1-2 minutes for regular notifications
  • Delayed: Up to 5 minutes during high volume periods

If delays persist:

  1. Check your email provider's status
  2. Verify network connectivity
  3. Contact support@astropulse.io

🔗 Integration with Email Tools​

Email Rules and Filters​

Set up email rules to automatically:

  • Organize: Sort notifications into dedicated folders
  • Forward: Send critical alerts to on-call team members
  • Label: Tag notifications by priority or event type

Third-Party Integration​

Email notifications work seamlessly with:

  • Gmail: Labels, filters, and forwarding rules
  • Outlook: Rules, categories, and shared mailboxes
  • Apple Mail: Rules and smart mailboxes
  • Thunderbird: Message filters and tags

📈 Advanced Usage​

Multiple Organizations​

If you're part of multiple organizations:

  • Each organization has separate email channel configuration
  • Use different email addresses for different organizations
  • Configure subscriptions independently per organization

Bulk Operations​

  • Unsubscribe All: Opt out of all email notifications (compliance-friendly)
  • Resubscribe All: Re-enable all previously disabled subscriptions
  • Channel Toggle: Temporarily disable without losing configuration

Next Steps​

  • Add team notifications: Set up Slack integration for Enterprise teams
  • Customize alerts: Configure topic subscriptions for specific events
  • Monitor delivery: Verify notifications are reaching your inbox

Need help? Contact support@astropulse.io.