Creating an Incoming Webhook for Microsoft Teams Notifications

 

This guide explains how to generate a unique Webhook URL using the Teams Workflows app. External services (like orchestration, CI/CD, or monitoring tools) will use this URL to post messages directly to a specific Teams channel.

Prerequisites

  • Access to Microsoft Teams.

  • Permissions to add workflows to the target Team/Channel.

Step-by-Step Instructions

1. Access the Workflows App

  • Open Microsoft Teams.
  • On the left-hand sidebar, click on the Apps icon (or the three dots ... if you have already pinned it).
  • Search for and select Workflows.

2. Initiate Creation

  • Once inside the Workflows app, navigate to the Create tab at the top of the window.

3. Select the Webhook Template

  • In the search bar within the Create tab, type: webhook.
  • Look for the template titled "Post to a channel when a webhook request is received" (or similar variations like "Send webhook alerts to a channel").
  • Click on the template card to select it.

4. Naming and Connections

  • You may be prompted to confirm your connection credentials. Ensure there is a green check mark next to the Microsoft Teams icon.
  • Click Next.

5. Configure Team and Channel

  • Select Team: Choose the specific Team where you want the alerts to appear.
  • Select Channel: Choose the specific Channel within that Team for the messages.
  • Click Add workflow.

6. Retrieve the Webhook URL

  • The workflow will now be generated.
  • The system will present a Webhook URL.
  • Action: Copy this URL immediately and save it in a secure location. This is the endpoint address you will use in your external application to send data to Teams.
  • Click Done.

Key Takeaway

The final copied Webhook URL is the secure endpoint for your orchestration system. Treat it as a password.