Create Incoming Webhooks

An Incoming Webhook lets external applications share content in Microsoft Teams channels. The webhooks are used as tools to track and notify. The webhooks provide a unique URL to send a JSON payload with a message in card format. Cards are user interface containers that include content and actions related to a single article. You can use cards in the following capabilities:

• Bots
• Message extensions
• Connectors

Key features of Incoming Webhooks

The following table provides the features and description of an Incoming Webhook:

Create Webhooks using Workflows

The Workflows app in Microsoft Teams enables you to create automated workflows that can receive HTTP requests through a webhook URL. When the webhook triggers, the workflow can post a message or an Adaptive Card to a Teams channel or chat.

Workflows are powered by Microsoft Power Automate and provide a flexible way to process webhook payloads before posting them to Teams.

Create an incoming webhook from a template

You can create a webhook workflow directly from a channel using a template.

1. In Microsoft Teams, go to the team and channel where you want to receive webhook messages.
2. Select More options (...) next to the channel.
3. Select Workflows.
4. Search for and select a template such as Send webhook alerts to a channel.
5. Configure the workflow parameters.
6. Select Save.
7. After the workflow is created, copy the webhook link. Use the webhook URL in your external application or service to send HTTP POST requests.

When a request is received, the workflow posts the configured message to the selected channel.

Create a webhook workflow from scratch

You can also create a webhook workflow manually using the Workflows app.

1. In Microsoft Teams, select Apps. The app gallery appears.

2. Search for and open the Workflows app.

3. Select Build from scratch.

4. Select the trigger When a Teams webhook request is received.

5. Configure the trigger settings.

6. Save the workflow.

Send a request to the webhook

After creating the workflow, send an HTTP POST request to the generated webhook URL.

POST <WEBHOOK_URL>
Content-Type: application/json

{
    "text": "Hello from a webhook workflow!"
}

When the request is received, the workflow processes the payload and posts the message to the configured Teams channel or chat.

When to use Workflows for webhooks

Use Workflows when you need to:

• Receive webhook requests from external services.
• Post messages or Adaptive Cards to Teams channels or chats.
• Transform or process webhook payloads before posting them to Teams.
• Integrate webhook events with other services supported by Power Automate.

You can create and send actionable messages through an Incoming Webhook or connector for Microsoft 365 Groups. For more information, see create and send messages.

Example

var adaptiveCardJson = @"{
  ""type"": ""message"",
  ""attachments"": [
    {
      ""contentType"": ""application/vnd.microsoft.card.adaptive"",
      ""content"": {
        ""type"": ""AdaptiveCard"",
        ""body"": [
          {
            ""type"": ""TextBlock"",
            ""text"": ""Message Text""
          }
        ],
        ""$schema"": ""http://adaptivecards.io/schemas/adaptive-card.json"",
        ""version"": ""1.0""
      }
    }
  ]
}";

var webhookUrl = "https://xxxxx.webhook.office.com/xxxxxxxxx";

var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var content = new StringContent(adaptiveCardJson, System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync(webhookUrl, content);

var formatted_Card_Payload = {
        "type": "message",
        "attachments": [
            {
                "contentType": "application/vnd.microsoft.card.adaptive",
                "contentUrl": null,
                "content": {
                    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
                    "type": "AdaptiveCard",
                    "version": "1.2",
                    "body": [
                        {
                            "type": "TextBlock",
                            "text": "Submitted response:"+ response
                        }
                    ]
                }
            }
        ]
    }

var webhookUrl = "https://xxxxx.webhook.office.com/xxxxxxxxx";

axios.post(webhookUrl , formatted_Card_Payload )
    .then(res => {
        console.log(`statusCode: ${res.status}`)
        console.log(res)
    })
    .catch(error => {
        console.error(error)
    })

Manage your workflows

You can manage your workflows by turning them on or off, or by deleting them when no longer needed.

Turn on or turn off your workflow

Turn on or turn off a workflow at any time from the Workflows app.

1. Open the Workflows app.

2. Scroll down the Home page to find the Your workflows section.

3. Next to the workflow you want to turn on or turn off, select More actions (…).

4. From the menu, select Turn on or Turn off.

   

Delete your workflow

Remove a workflow from your list at any time.

1. Open the Workflows app.

2. Scroll down the Home page to find the Your workflows section.

3. Next to the workflow you want to delete, select More actions (…).

4. Select Delete.

5. In the confirmation window, select Delete to permanently remove the workflow.

   

Code sample

See also

• Create Outgoing Webhooks
• Build bots for Teams
• Message extensions
• Integrate web apps
• Share to Teams from web apps