> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/harness-platform/use-harness-platform/notifications-alerts-and-banners/notifications/send-notifications-to-microsoft-teams.md).

# Send notifications to Microsoft Teams

Harness notifies your User Groups of events in Pipelines, and general alerts.

You can integrate your Harness User Group with Microsoft Teams and receive notifications in Teams channels.

Setup is a simple process of generating a Webhook in Microsoft Teams and adding it to a Harness User Group's Notification Preferences. Let's get started.

#### Before you begin <a href="#before-you-begin" id="before-you-begin"></a>

* See [User Group Notification Preferences](/harness-platform/use-harness-platform/platform-access-control/add-user-groups.md#edit-notification-preferences)

#### Review: Requirements <a href="#review-requirements" id="review-requirements"></a>

We assume you have a Microsoft Teams administrator account.

#### Step 1: Create a Webhook in Microsoft Teams <a href="#step-1-create-a-webhook-in-microsoft-teams" id="step-1-create-a-webhook-in-microsoft-teams"></a>

1. In Microsoft Teams, right-click the channel name where you want to send notifications, and select **Workflows** from the menu.

![](/files/aPwuHhCXHHfvfvbt9KG9)

2. In the **Workflows** section, select the workflow **Post to a channel when webhook request is received**.

![](/files/ki6Af7VgAY2VoAmSbAbX)

3. Provide a name for the webhook, then click **Next**.

![](/files/TGTabcbWTY1DsW6oNN2Z)

4. Select the **Team** and **Channel** where you’d like to receive notifications, then click **Add Workflow**.

![](/files/1tB0wpyLcr2peimfQ5zZ)

5. A webhook URL will be generated. Copy this URL for use in Harness.

![](/files/lz8tejgM68dupcXMYEU8)

#### Step 2: Add Webhook to Harness User Group Notification Preferences <a href="#step-2-add-webhook-to-harness-user-group-notification-preferences" id="step-2-add-webhook-to-harness-user-group-notification-preferences"></a>

In your **Account**/**Organization**/**Project** click Access Control.

Click **User Groups**.

Select the User Group to which you want to add notification preferences.

In **Notification Preferences**, select **Microsoft Teams Webhook URL**.

Paste the Webhook into **Microsoft Teams Webhook URL** or add it as an [Encrypted Text](/harness-platform/use-harness-platform/secrets/add-use-text-secrets.md) in Harness and reference it here.

For example, if you have a text secret with the identifier `teamswebhookURL`, you can reference it like this: ​

```
<+secrets.getValue("teamswebhookURL")>​​
```

You can reference a secret within the Org scope using an expression with `org`:​

```
<+secrets.getvalue("org.your-secret-Id")>​
```

You can reference a secret within the Account scope using an expression with `account`:​

```
<+secrets.getvalue("account.your-secret-Id")>​
```

Click **Save**.

![](/files/dnD7KTF7nz1ulwh4M9fJ) Now your Microsoft Teams channel will be used to notify this User Group of alerts.