Create Incoming Webhook

Incoming Webhook allows any external apps to share content in Teams channels. These webhooks are used as tracking and notifying tools. They provide a unique URL, to which you send a JSON payload with a message in card format. Cards are user interface containers that include content and actions related to a single topic. Teams use cards within the following capabilities:

  • Bots
  • Messaging extensions
  • Connectors

Key features of Incoming Webhook

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

Features Description
Adaptive Cards using an Incoming Webhook Adaptive Cards can be sent through Incoming Webhooks. For more information, see Send Adaptive Cards using Incoming Webhooks.
Actionable messaging support Actionable message cards are supported in all Office 365 groups including Teams. If you send messages through cards, you must use the actionable message card format. For more information, see legacy actionable message card reference and message card playground.
Independent HTTPS messaging support Cards provide information clearly and consistently. Any tool or framework that can send HTTPS POST requests can send messages to Teams through an Incoming Webhook.
Markdown support All text fields in actionable messaging cards support basic Markdown. Do not use HTML markup in your cards. HTML is ignored and treated as plain text.
Scoped configuration Incoming Webhook is scoped and configured at the channel level.
Secure resource definitions Messages are formatted as JSON payloads. This declarative messaging structure prevents the insertion of malicious code.

Note

  • Teams bots, messaging extensions, Incoming Webhook, and the Bot Framework support Adaptive Cards, an open cross card platform framework. Currently, Teams connectors do not support Adaptive Cards. However, it is possible to create a flow that posts Adaptive Cards to a Teams channel.
  • For more information on cards and webhooks, see Adaptive cards and Incoming Webhooks.

Create Incoming Webhook

To add an Incoming Webhook to a Teams channel

  1. Go to the channel where you want to add the webhook and select ••• More options from the top navigation bar.

  2. Select Connectors from the dropdown menu:

    Select Connector

  3. Search for Incoming Webhook and select Add.

  4. Select Configure, provide a name, and upload an image for your webhook if required:

    Configure button

  5. The dialog window presents a unique URL that maps to the channel. Copy and save the webhook URL, to send information to Microsoft Teams and select Done:

    Unique URL

The webhook is available in the Teams channel.

Note

In Teams, select Settings > Member permissions > Allow members to create, update, and remove connectors, so that any team member can add, modify, or delete a connector.

Remove Incoming Webhook

To remove an Incoming Webhook from a Teams channel

  1. Go to the channel.

  2. Select ••• More options from the top navigation bar.

  3. Select Connectors from the dropdown menu.

  4. On the left, under Manage, select Configured.

  5. Select the <1> Configured to see a list of your current connectors:

    Configured webhook

  6. Select Manage next to the connector that you want to remove:

    Manage webhook

  7. Select Remove:

    Remove webhook

    The Remove Configuration dialog box appears:

    Remove Configuration

  8. Complete the dialog box fields and checkboxes and select Remove:

    Final Remove

    The webhook is removed from the Teams channel.

See also