> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metabase Webhook Setup Guide

> Configure Metabase to deliver events to StackOne.

## Prerequisites

The connector should already be set up, with a Connector Profile and a Linked Account. See [Getting Started](https://docs.stackone.com/connectors/metabase.md#getting-started) on the Metabase connector page.

## Retrieve the Native Webhook URL

The **Native Webhook URL** is StackOne's address for your Metabase account. It appears on the form you use to link your Metabase account in StackOne.

**1. Copy the Native Webhook URL**

On the account form in StackOne, find the **Native Webhook URL** field.

<ul>
  <li>Click the **Copy** icon next to **Native Webhook URL**.</li>
</ul>

![StackOne account form with the Copy icon next to the Native Webhook URL field highlighted](https://mintcdn.com/stackone-60/BwtTie-76qa393iV/connectors/metabase/images/events-copy-native-webhook-url.png?fit=max\&auto=format\&n=BwtTie-76qa393iV\&q=85\&s=f1e2f74781b339f6ec14c0465bdd8660)

## Configure Metabase

Metabase sends alert results to a webhook, so add StackOne as a webhook destination, then point an alert at it. Each alert sends the results of one saved question.

**1. Add the StackOne webhook**

Sign in to your Metabase as an admin.

<ul>
  <li>Click the **Settings** menu in the top right and select **Admin**.</li>
  <li>Open **Settings** > **Webhooks**.</li>
  <li>Click **Add a webhook**, or **Add another** when the page already lists webhooks.</li>
  <li>**Webhook URL**: the **Native Webhook URL**</li>
  <li>**Give it a name**: `StackOne`</li>
  <li>**Authentication method**: **None**</li>
  <li>Click **Create destination**.</li>
</ul>

![Metabase New webhook destination form with the Webhook URL, Give it a name, None and Create destination controls highlighted](https://mintcdn.com/stackone-60/BwtTie-76qa393iV/connectors/metabase/images/events-add-webhook.png?fit=max\&auto=format\&n=BwtTie-76qa393iV\&q=85\&s=8633e043a2e949aa0fe4562e3967e2b6)

**2. Create an alert on a question**

Open the saved question whose results StackOne should receive.

<ul>
  <li>Click the three-dot menu in the top right.</li>
  <li>**Question with no alerts:** select **Create an alert**.</li>
  <li>**Question with alerts:** select **Edit alerts**, then click **New alert**.</li>
  <li>**Check**: how often Metabase checks the question</li>
  <li>**at**: the time of day to check</li>
</ul>

![Metabase question menu with the three-dot button and Edit alerts highlighted](https://mintcdn.com/stackone-60/BwtTie-76qa393iV/connectors/metabase/images/events-create-alert.png?fit=max\&auto=format\&n=BwtTie-76qa393iV\&q=85\&s=a2560dee757fdff0cc82f10e018e801e)

**3. Add StackOne as the destination**

Under **Where do you want to send the results?**, add the StackOne webhook.

<ul>
  <li>Click **Add another destination**.</li>
  <li>Select **StackOne** under **Webhooks**.</li>
  <li>Click the remove icon next to **Email** to send the alert only to StackOne.</li>
  <li>Click **Done**.</li>
  <li>Note: **Send now** sends the alert's current results straight away.</li>
</ul>

![Metabase New alert form with the check time, the StackOne destination and Done highlighted](https://mintcdn.com/stackone-60/BwtTie-76qa393iV/connectors/metabase/images/events-send-alert-to-stackone.png?fit=max\&auto=format\&n=BwtTie-76qa393iV\&q=85\&s=b90833c4010bfe6a0d0043cdaa9cce55)

## Available webhook events

The following Metabase event can be enabled. Only events selected in StackOne are delivered.

**1. Alert events**

Events from alerts on saved questions.

<ul>
  <li>**Alert Sent** (`alert`) — Fired when an alert sends a question's results to the StackOne webhook, on its schedule when its condition is met or when someone clicks **Send now**</li>
</ul>

## Delivery format

Details of how Metabase delivers alerts to StackOne.

<ul>
  <li>Each alert send is one JSON request with `type` set to `alert`, carrying the question's ID, name and link, its result columns and rows, and the chart as a base64 PNG image.</li>
  <li>Metabase doesn't sign webhook deliveries.</li>
</ul>

## Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.