Overview

This guide shows how to configure UpGuard to post notifications into a MS Teams channel when a new Data Leak finding is published. Although we have used the Data Leak notification type here, you should be able to use this guide for other notification types. Please contact UpGuard Support if you need any assistance with your integration.

Prerequisites

You will need to generate a MS Teams Incoming Webhook URL. Navigate to your Teams interface and locate the channel you want to post notifications into. Here we are going to post UpGuard notifications into the "engineering" channel.

Click on the "..." drop down menu next to the channel and select Connectors:

Locate the Incoming Webhook type of connector and click Add:

On the preview window, click Add again to start configuring the webhook:

Next set a descriptive name for the new webhook and optionally set a logo. Here we're going to call our webhook UpGuard Data Leaks and we've inserted the UpGuard logo.

Clicking Create will generate a webhook URL, which you should keep handy for the integration setup steps below.

Clicking Done will complete the webhook setup and you should now see this new webhook in your list of connectors, under the Configured section.

Adding the Integration in UpGuard

Navigate to Account Settings on the left panel, then click the Integrations tab. Click New Integration to start creating a new integration.

Give your integration a descriptive name. Click Confirm and Next to continue:

Next, select the trigger type. In this case we are going to select the When a new data leak is published trigger. Click Confirm and Next:

Next, you will be entering the destination details. For an MS Teams integration, you should enter in the Incoming Webhook URL you saved from above into the Webhook URL field. For HTTP Headers field, set "Content-Type: application/json" as the payload will be in JSON format. Click Confirm and Next to move to the Payload screen.

To begin with, you can define your Payload template like this:

{
"text": "{{ notification.description }}"
}

Under the payload editor, click Send test message to confirm that your integration is configured correctly. You should see a test post matching the sample appear in your MS Teams channel within a few seconds.

Click Confirm and Next to complete the integration setup and remember to enable the integration before clicking Finish.

What Next?

For information on other types of notifications that can be sent to your MS Teams channels, please view our guide on What are notifications in UpGuard?

Did this answer your question?