Skip to main content
Alerts
Get notified on Email or Slack of high-value whales and important user actions:
  • Key user events (connect wallet events, conversions, drop off)
  • When whales and high-value users visit your app
In the project settings page, you can create an alert that will notify you via:
  • Email
  • Webhooks

​
Webhooks

Webhooks allow you to send alerts to your own server or third-party service. You can set up a webhook URL in the project settings, and when an alert is triggered, a POST request will be sent to that URL with the alert data. Here’s an example of the JSON payload that will be sent to your webhook: 
{
  "alert_id": "XXXX_Test Alert 3_1753771336519_1753771433251",
  "alert_name": "Test Alert 3",
  "project_id": "XXXX",
  "project_name": "Example",
  "team_id": "XXXX",
  "event": {
    "properties": {
      "chain_id": 84532
    },
    "address": "0xF04bC8FdFC8b1c03Fa77885574Ae6Ea041E26bdc",
    "type": "connect",
    "locale": "en-US",
    "timezone": "Asia/Saigon",
    "location": "VN",
    "timestamp": "2025-07-29T06:42:16.519Z",
    "anonymous_id": "4b48c7b6-3d61-409f-b695-1d9452954d6b"
  },
  "timestamp": "2025-07-29T06:43:53.268Z",
  "webhook_version": "1.0"
}

​
How to set up your first alert

Get real-time notifications when high-value users interact with your app. This guide walks you through creating alerts for whale detection and key events.

​
Step 1: Navigate to Alerts

  1. Go to the Formo Dashboard
  2. Select your project
  3. Click Settings in the left navigation (gear icon)
  4. Select the Alerts tab

​
Step 2: Create a new alert

  1. Click Create Alert
  2. Configure your alert:
SettingDescription
NameDescriptive name (e.g., “Whale Alert”)
Event TypeWhich event triggers the alert
ConditionsFilter conditions (optional)
NotificationEmail or Webhook

​
Step 3: Choose an event type

Select which events should trigger notifications:
Event TypeWhen it fires
connectUser connects their wallet
transactionUser submits a transaction
pageUser visits a specific page
customYour custom tracked events

​
Step 4: Add filter conditions (optional)

Make alerts more targeted by adding conditions: Example: Alert only for whales
  • Event type: connect
  • Condition: net_worth > 100000
Example: Alert for specific contract interaction
  • Event type: transaction
  • Condition: contract_address = 0x...

​
Step 5: Configure notifications

  1. Select Email as the notification type
  2. Enter the email addresses to notify
  3. Alerts arrive in real-time as events occur

​
Step 6: Test your alert

  1. Save your alert configuration
  2. Trigger a test event:
    • Visit your app in a browser
    • Connect a wallet
    • Perform the action that matches your alert
  3. Check your email or webhook endpoint for the notification

​
Example: Whale detection alert

Here’s a practical alert configuration to notify you when high-value users visit:
SettingValue
NameWhale Alert
Event typeconnect
Conditionnet_worth > 100000
NotificationSlack webhook
Every time a wallet with over $100k net worth connects, you’ll get a Slack message with their details.

​
Example: Failed transaction alert

Track when users encounter issues:
SettingValue
NameFailed TX Alert
Event typetransaction
Conditionstatus = failed
NotificationEmail
Get notified when transactions fail so you can investigate UX issues.

​
Webhook integration examples

Send to Slack: 
# Your Slack webhook URL
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
Send to Zapier: 
# Your Zapier webhook URL
https://hooks.zapier.com/hooks/catch/123456/abcdef/
Then use Zapier to route alerts to any destination: Notion, Airtable, Discord, SMS, etc.

​
Next Steps

Wallet Profiles

Learn more about user data available in alerts

Custom Events

Track custom events to alert on

Webhooks API

Full webhook documentation

User Segments

Target specific user groups with alerts