Back to Documentation

Price Alerts

Set up email notifications and webhooks for price changes

Alert Overview

RivalPrice offers two types of alerts: email notifications and webhooks. Email notifications are perfect for staying informed, while webhooks allow you to integrate price changes directly into your own systems and applications.

Email Notifications

Setting Up Email Alerts

Email notifications are the simplest way to stay informed about price changes. You'll receive an email whenever a price change matches your criteria.

  1. Go to your account settings or the Alerts section
  2. Enable email notifications in your preferences
  3. Configure which events you want to be notified about:
    • Price drops
    • Price increases
    • Price below your price
    • Price above your price
    • Any price change
  4. Set price change thresholds (e.g., alert if price drops by 5% or more)
  5. Optionally filter by specific products or competitors
  6. Test your email notification to ensure it works

Email Notification Features:

  • Instant delivery when price changes occur
  • Rich email templates with price comparison
  • Unsubscribe options in every email
  • No technical setup required

Webhooks

Setting Up Webhooks

Webhooks allow you to receive real-time HTTP callbacks when price changes occur. This is perfect for integrating with your own systems, automation tools, or applications.

  1. Go to the Webhooks section in your dashboard
  2. Click "Create Webhook"
  3. Enter your webhook URL (must be HTTPS)
  4. Select the event type you want to monitor (e.g., "price.changed")
  5. Configure rules to filter which price changes trigger the webhook:
    • Specific products or competitor URLs
    • Price change thresholds (percentage or dollar amount)
    • Price ranges (min/max)
  6. Save your webhook
  7. Test the webhook to verify it works

Webhook Use Cases:

  • Automatically update your prices when competitors change theirs
  • Trigger alerts in Slack, Discord, or other messaging platforms
  • Update your inventory management system
  • Feed data into your analytics or BI tools
  • Integrate with automation platforms like Zapier or Make

Webhook Security:

Each webhook includes a signature header (X-Webhook-Signature) that you should verify to ensure requests are from RivalPrice. See the Webhooks documentation for details.

Available Alert Events

Price Events
  • price.changed - Any price change
  • price.dropped - Price decreased
  • price.increased - Price increased
  • price.below_your_price - Competitor below you
  • price.above_your_price - Competitor above you
Other Events
  • scrape.failed - URL scraping failed
  • scrape.successful - Successful price update
  • average_price.changed - Average price changed
  • lowest_price.changed - Lowest price changed
  • highest_price.changed - Highest price changed

Best Practices

Set Appropriate Thresholds

Don't alert on every tiny price change. Set meaningful thresholds (e.g., 5% or $10) to avoid alert fatigue while still catching important changes.

Use Filters Wisely

Filter alerts by specific products or competitors that matter most to your business. This reduces noise and focuses on actionable insights.

Test Your Webhooks

Always test webhooks after creating them. Use the test feature to send a sample event and verify your endpoint receives and processes it correctly.

Next Steps

For detailed technical documentation on webhooks and email notifications:

Webhooks DocumentationAPI Reference