Notifications & Alerts

Stay informed about important marketplace events with customizable notifications.

Overview

Automatum sends notifications for key events across your marketplace operations, ensuring you never miss important updates about contracts, customers, or revenue.

Notification Channels

Email Notifications

Receive updates via email:

• Immediate delivery
• HTML formatted
• Mobile-friendly
• Includes action links

Current Support

Email notifications are currently available for:

• Private offers (when enabled in preferences)
• Status updates (when enabled in preferences)
• Special offers (marketing, when enabled)
• Blog posts (when enabled)

Webhooks

Build custom integrations with real-time HTTP callbacks:

• Subscribe to specific events
• Receive JSON payloads
• Multiple webhooks per organization
• Configure per-webhook event subscriptions
• Auto-disable after 10 consecutive failures
• Webhook management via dashboard

See Webhook Documentation for complete details.

Event Types

Available webhook events are organized by category:

Entitlement Events

• entitlement.created - New entitlement created
• entitlement.expired - Entitlement has expired
• entitlement.renewed - Entitlement renewed
• entitlement.cancelled - Entitlement cancelled
• entitlement.updated - Entitlement details updated

Private Offer Events

• private_offer.created - Private offer created
• private_offer.accepted - Private offer accepted by customer
• private_offer.expired - Private offer expired
• private_offer.updated - Private offer details updated
• private_offer.cancelled - Private offer cancelled

Customer Events

• customer.created - New customer registered
• customer.updated - Customer information updated
• customer.deleted - Customer removed

Metering Events

• metering.submitted - Metering data submitted
• metering.confirmed - Metering confirmed by marketplace
• metering.failed - Metering submission failed

Configure Events

Subscribe to specific events when creating webhooks in Settings > Integrations > Webhooks. Each webhook can subscribe to different events.

Configuring Notifications

Email Notification Preferences

Access settings at Preferences > Notifications

Available Settings:

Listings

• Private Offers - Get notified about private offer updates
• Status Updates - Get notified when listing status changes

Marketing

• Special Offers - Receive special marketplace offers
• Blog Posts - Get notified about new blog posts

Per-User Settings

Each user can configure their own email notification preferences independently.

Webhook Configuration

Create Webhook:

1. Go to Settings > Integrations > Webhooks
2. Click Create Webhook
3. Fill in webhook details:
   • Name
   • Endpoint URL (must be HTTPS)
   • Secret (optional, for signature verification)
4. Select events to subscribe to
5. Save webhook

Webhook Features:

• Subscribe to specific events per webhook
• Multiple webhooks supported
• Auto-disabled after 10 consecutive failures
• Track last triggered time and failure count
• Edit or delete webhooks anytime

For complete webhook documentation including payload structures, retry logic, and security, see Webhook Documentation.

Troubleshooting

Not Receiving Emails

Check:

• Email preferences enabled
• Correct email address
• Spam/junk folder
• Email filters
• Domain whitelist

Whitelist Automatum:

Sender: notifications@automatum.io
Domain: automatum.io

Slack Notifications Missing

Verify:

• Slack integration connected
• Correct channel selected
• Bot has channel permissions
• Workspace not suspended

Reinstall Integration:

1. Remove Slack integration
2. Re-authorize workspace
3. Reconfigure settings
4. Test notification

Webhook Not Receiving Events

Debug:

• Endpoint is accessible (HTTPS)
• Returns 200 status code
• Processes requests quickly (<5s)
• Valid SSL certificate

Test Webhook:

# Send test event
POST /api/webhook/test
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "webhookId": "webhook_123"
}

Best Practices

1. Start Conservative: Enable critical alerts first
2. Use Channels Wisely: Match channel to urgency
3. Customize Templates: Add branding and context
4. Set Quiet Hours: Respect work-life balance
5. Monitor Engagement: Track and optimize
6. Test Regularly: Verify notifications work
7. Document Alerts: Maintain alert runbook

Next Steps

• Configure webhooks - Complete webhook documentation
• Set up OAuth API - Build custom integrations
• Configure notification preferences

Need Help?

Contact hello@automatum.io for assistance with notifications and alerts.