Skip to main content
Alerts
Get notified in real time when high-value whales and important user actions happen:
  • 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:
  • Webhooks (including Slack via incoming 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. When an alert is triggered, Formo batches all matching events into a single webhook call. The generic webhook payload uses the alerts.triggered event type and contains raw analytics events from Tinybird: 
{
  "id": "evt_3f7f9c4e-8b2c-4d1f-9a4b-4a2e9c1d2f01",
  "type": "alerts.triggered",
  "created": 1739097600,
  "data": [
    {
      "project_id": "proj_123",
      "session_id": "sess_456",
      "channel": "web",
      "type": "connect",
      "anonymous_id": "4b48c7b6-3d61-409f-b695-1d9452954d6b",
      "user_id": "",
      "address": "0xF04bC8FdFC8b1c03Fa77885574Ae6Ea041E26bdc",
      "event": "Connected wallet",
      "context": {
        "ip": "203.0.113.10",
        "user_agent": "Mozilla/5.0 ..."
      },
      "properties": {
        "chain_id": 84532,
        "net_worth": 250000
      },
      "version": "1",
      "timestamp": "2026-02-09T06:42:16.519Z",
      "message_id": "msg_01J8ABCDEF1234567890",
      "origin": "app.formo.so",
      "locale": "en-US",
      "location": "VN",
      "timezone": "Asia/Saigon",
      "page_path": "/pricing",
      "page_title": "Pricing",
      "page_url": "https://app.formo.so/pricing",
      "page_query": "",
      "page_hash": "",
      "library_name": "@formo/sdk-js",
      "library_version": "1.0.0",
      "referrer_url": "https://google.com/",
      "referrer": "google.com",
      "ref": "",
      "utm_source": "google",
      "utm_medium": "cpc",
      "utm_campaign": "whale-acquisition",
      "utm_term": "",
      "utm_content": "",
      "user_agent": "Mozilla/5.0 (...)",
      "device": "desktop",
      "browser": "Chrome",
      "os": "MacOS"
    }
  ]
}
For Slack incoming webhooks (hooks.slack.com), Formo sends the same events but formatted as a Slack Block Kit table (Time, Event, User, Country, Device, Browser, OS, Referrer) instead of the raw Tinybird rows.

​
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)
NotificationWebhook (generic HTTP or Slack)

​
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: Configure notifications

  1. Select Webhook as the notification type
  2. Enter your webhook URL (generic HTTPS endpoint or Slack incoming webhook)
  3. Formo sends a POST request with batched event data
Generic webhook payload (raw events):
  • id - Crypto UUID for this alert delivery (e.g., evt_...)
  • type - Always alerts.triggered
  • created - Unix timestamp (seconds) when the webhook was created
  • data - Array of raw analytics events (Tinybird rows) that matched your filters
Slack webhook payload (formatted table):
  • Automatically detected when the URL host contains hooks.slack.com
  • Events are rendered as a Slack Block Kit table (Time, Event, User, Country, Device, Browser, OS, Referrer)
  • Up to 50 events are shown per alert, with a truncation note if more were found
Webhook security and signatures:
  • Optional secret: In the alert configuration, you can provide a signing secret used to verify requests on your server.
  • Usage: For generic webhooks (non-Slack URLs), Formo uses your secret to compute an HMAC-SHA256 signature over the string {timestamp}.{body}, where:
    • timestamp is the Unix timestamp (seconds) used for the request
    • body is the exact JSON payload string sent in the request
HTTP headers sent:
  • Content-Type: application/json
  • User-Agent: Formo-Alerts/1.0
  • X-Formo-Alert-Id: The alert ID in Formo
  • X-Webhook-Signature: HMAC-SHA256 signature (only for generic webhooks when a secret is set)
  • X-Webhook-Timestamp: Unix timestamp (seconds) used in the signature (only for signed generic webhooks)
  • X-Webhook-Event: Always alerts.triggered (only for signed generic webhooks)

​
Step 5: 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 Slack channel 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
NotificationWebhook (generic HTTPS or Slack)
Get notified when transactions fail so you can investigate UX issues through your own incident tooling or Slack.

​
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