How to set up notifications and integrations

How it works

There are two separate concepts to understand before you start:

• Integrations are connections to external services like Slack, Discord, or a custom webhook. Each integration belongs to one site.
• Notification rules are the conditions that trigger a notification. Rules live inside individual sites and reference one or more integrations. A rule does nothing until it has an integration attached—and an integration does nothing until a rule uses it.
• Notifications are the messages that are sent when a rule is triggered. A notification can be sent as a json object or a template with variables.

Step 1: Create an integration

Open the site you want alerts for and click Integrations in the sidebar. On the Available tab, choose the service you want to connect.

For notifications, Pieowl supports:

• Slack — authenticate via OAuth and pick a channel
• Discord — paste a Discord webhook URL for a channel
• Webhook — send an HTTP POST to any URL you control

Fill in the required details and save. The integration is now available to the notification rules for this site.

Step 2: Go to your site's notification rules

Integrations alone don't do anything. To start receiving alerts, open the site you want to monitor, click Notifications in the left sidebar, and switch to the Rules tab.

Click Add Rule to open the rule editor on the right side of the screen.

Give your rule a name, then choose a Type. There are two types:

Event rules

Event rules fire in real time. The moment Pieowl receives an event that matches your filters, the notification is sent.

In the rule editor:

1. Set Type to Events
2. Add one or more events from the Events list. You can filter each event by its properties (for example, only trigger when path starts with /onboarding)
3. Write a Template for the notification message. Use {{property_name}} to insert event properties dynamically—for example, New user with their first event from {{country}}.
4. Under Integrations, select which integration(s) should receive the notification

Click Update to save the rule.

Funnel rules

Funnel rules let you track multi-step flows and notify you only when a user completes every step in the correct sequence—for example, session_start → subscription_checkout → subscription_created.

In the rule editor:

1. Set Type to Funnel
2. Add each event in the funnel, in the order they must occur. You can optionally add property filters to each step
3. Write a Template for the notification message
4. Select your Integration(s)

Click Update to save.

View notifications

Switch to the Notifications tab (the default view) to see every notification that has been triggered for your site. Each row shows the notification title alongside the country, OS, browser, and profile of the user who triggered it.

You can filter the list by creation date or search by title to find specific events.

Frequently asked questions