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

# Notification Integrations

> Configure Slack, Webhook, Microsoft Teams, and PagerDuty notification channels in Matia.

# Notification Integrations Setup Guide

Matia allows you to send real-time notifications to external systems so your team can stay in the loop when important events occur.

You can configure **multiple notification channels** and control where notifications are delivered across Matia.

Currently supported notification integrations:

* **Slack**
* **Webhook**
* **Microsoft Teams** (via Webhook)
* **PagerDuty**

***

## Supported Notification Channels

Once configured, these channels can be selected as **recipients throughout Matia** (alerts, monitors, failures, system events, and more).

Each channel is set up as a **named connection** that acts as a reusable destination.

***

## Slack Notifications

Slack is connected using a secure one-click OAuth flow.

### How to Connect Slack

1. Navigate to **Settings → Notifications → Add Notificaiton Integration**
2. Click **Connect with Slack**
3. Authorize Matia in your Slack workspace
4. Select the channel you’d like Matia to post into

Once connected, the Slack channel will be available as a notification recipient throughout Matia.

***

## Webhook Notifications

Webhooks allow you to send notifications to any external system that supports incoming HTTP requests.

You can configure **multiple webhook channels**.

### How to Add a Webhook Channel

1. Navigate to **Settings → Notifications → Add Notificaiton Integration**

2. Click **Add Webhook**

3. Fill in the following fields:

   * **Connection Name**\
     This is the name that will appear as the recipient channel throughout Matia (for example: `Data Team Webhook` or `Prod Alerts`)

   * **Webhook URL**\
     The destination endpoint where Matia will send notification events

4. Click **Connect**

Once saved, the webhook will be available as a destination throughout Matia.

***

## Microsoft Teams Notifications (via Webhook)

Matia supports Microsoft Teams notifications via **incoming webhooks** using the Microsoft **Workflows** app.

You can send Matia alerts (for issues, schema changes, monitor breaches, and more) directly into a Teams channel.

The high-level flow:

1. Create a webhook for a Teams channel using **Workflows**
2. Add that webhook to Matia
3. Route notifications to that channel

***

### Prerequisites

Before you start, make sure the **Workflows** app is available in your Microsoft 365 tenant, as this provides the webhook template used by Microsoft Teams.

***

### Part 1 – Create a Webhook in Microsoft Teams

1. Open **Microsoft Teams** (desktop or web).
2. In the left sidebar, select the **Team and Channel** where you want Matia alerts to appear.
3. Next to the channel name, click the **⋯ (More options)** menu.
4. From the menu, choose **Workflows** (or **Apps → Workflows**, depending on your UI).
5. In the Workflows window, search for **“webhook”**.
6. Select the template:\
   **Post to a channel when a webhook request is received**
7. Click **Next**.
8. Confirm that the **Team** and **Channel** values match the destination for Matia alerts.
9. Click **Add workflow**.
10. When Microsoft Teams displays the generated **Webhook URL**, click **Copy**, then click **Done**.

You now have a webhook URL that Matia can use to post alerts to this channel.

***

### Part 2 – Add Microsoft Teams as a Destination in Matia

1. Log in to **Matia**.

2. Navigate to **Settings → Notifications → Add Notificaiton Integration**

3. Click **Add Notification Integration**.

4. Choose **Add Webhook**.

5. Fill in the details:

   * **Connection Name**\
     Choose a name that clearly identifies the Teams channel.

   * **Webhook URL**\
     Paste the Teams webhook URL you copied earlier.

6. Click **Connect**.

Matia can now send notifications to your Microsoft Teams channel.

***

### Part 3 – Route Matia Alerts to Microsoft Teams

Once configured, your new Teams webhook channel will appear in:

* Monitor configurations
* Integration alert settings
* Notification rules created from the Notifications page

Select this channel wherever you configure alert routing, and Matia will post matching events directly into your Teams channel.

***

## PagerDuty Notifications

PagerDuty notifications allow Matia to trigger incidents directly in your PagerDuty account.

Matia uses **PagerDuty Events API V2**.

### How to Connect PagerDuty

1. Navigate to **Settings → Notifications → Add Notificaiton Integration**

2. Click **Add PagerDuty**

3. Enter the following:

   * **Connection Name**\
     This is the name that will appear as the recipient channel throughout Matia

   * **Integration Key**\
     This key comes from your PagerDuty service (see instructions below)

4. Click **Validate**

After validation, Matia sends a **test event** to PagerDuty to confirm the connection.

***

## How to Obtain a PagerDuty Integration Key

To generate the Integration Key required by Matia:

1. In PagerDuty, navigate to the **Services** tab and create a **new Service** for Matia.
2. Provide a **descriptive name** for the service (for example: `Matia Notifications`).
3. Choose the **Escalation Policy** you’d like to use for Matia notifications and follow the rest of PagerDuty’s setup steps.
4. When you reach the **Integrations** step, select **Events API V2** and click **Create Service**.
5. On the new Service page, under the **Integrations** section, you’ll see an **Integration Key** listed on the left side. Copy this key — you’ll need it to complete the setup in Matia.

<img src="https://mintcdn.com/matia/vcIqEnGvI59TVNCB/images/pagerduty-integration-key.png?fit=max&auto=format&n=vcIqEnGvI59TVNCB&q=85&s=42300fdbc7bf222e5e81fdec4f67299a" alt="PagerDuty Integration Key" width="1663" height="990" data-path="images/pagerduty-integration-key.png" />
