Notification Hooks

A notification hook is an alert that watches one of your saved Metabase questions and notifies the people you choose whenever a condition is met - for example, when overdue items appear in your data or a value crosses a target. Notifications can be sent by email, push, or both.

Notification hooks live on the project's Analytics page, in the Notification Hooks card.

Before you start

You need a saved question in your project's Metabase workspace to watch. A hook watches a question, not a dashboard. Open Metabase from the Analytics page, build and save the question you want to monitor, and note its URL (it will look like .../question/41-group-by-family).

The Notification Hooks card

The card lists every hook in your project. Each hook shows its name (or the question ID if you did not name it) and a summary of how it is set up: the channel, the condition, how often it is checked, and the number of recipients.

• Click the eye icon on a hook to view its full configuration.

• Click the trash icon to delete a hook.

• Click New Hook to create one.

If there are no hooks yet, the card shows No notification hooks yet.

Create a notification hook

1. On the Analytics page, click New Hook in the Notification Hooks card.

2. Fill in the form:

   • Metabase question URL or ID - paste the full question URL (for example .../question/41-group-by-family) or just the numeric ID (for example 41). Only question links work here; dashboard links are not accepted.

   • Name (optional) - a short label so you can recognise the hook in the list, such as "Overdue items alert".

   • Recipients - the email addresses to notify. Enter as many as you like, separated by commas, spaces, or new lines.

   • Email / Push - choose how the notification is delivered. Email is on by default. You must pick at least one channel.

   • Message - the text recipients see when the alert fires (optional).

   • Alert condition - what triggers the notification (see below).

   • Check frequency - how often Metabase re-runs the question to check the condition.

3. Click Create Hook. The new hook appears at the top of the Notification Hooks list.

Alert conditions

Condition	When it fires
Has results	Whenever the question returns at least one row - for example, when overdue items show up. This is the default.
Goal reached (above)	When the result rises above the goal line set on the question in Metabase.
Goal reached (below)	When the result drops below the question's goal line.

The two Goal reached conditions only work if you have set a goal on the question inside Metabase. If the question has no goal, use Has results.

Check frequency

Choose how often the question is re-run to check the condition: Every minute, Every 5 minutes, Every 15 minutes (the default), Hourly, or Daily. More frequent checks notify you sooner but query your data more often.

Push notifications only reach recipients who have an Information Hub account - other addresses are skipped. Email is sent to every recipient regardless of whether they have an account.

View or delete a hook

• View - click the eye icon on a hook to see its name, question ID, channels, condition, check frequency, recipients, and message in a read-only panel.

• Delete - click the trash icon to remove the hook. It stops firing immediately.