Create incoming webhooks with Workflows for Microsoft Teams

An Incoming webhook lets external applications share content in chats and channels in Microsoft Teams. Webhooks are used as tools to track and notify. You can post to a channel or chat when a webhook request is received.

Set up an incoming webhook workflow from a template

Select More options Microsoft Teams more options icon next to the channel or chat you want to create a workflow for, and then select Workflows Workflow logo.  

Depending on if you want the webhook to post within a chat or channel, choose the webhook template that best suits your needs. Each template has a different authentication type.

Chat webhook templates

  • Post to a chat when a webhook request is received

  • Post to a chat when a webhook request is received from specific users

  • Post to a chat when a webhook request is received from users in my tenant

Channel webhook templates

  • Post to a channel when a webhook request is received

  • Post to a channel when a webhook request is received from specific users

  • Post to a channel when a webhook request is received from users in my tenant

Screenshot showing workflow templates

The webhook template Post to a chat when a webhook request is received may not be available depending on your organization type. For more help, contact your IT admin.

Once the workflow opens, you can change its name.

You’ll also need to authenticate with your account to have your workflows post to the channel or chat. If you want to choose a different account to authenticate with, select Switch account Microsoft Teams more options icon and choose the account you want to use.

Once you're done updating the name and have the correct account authenticated, select Next.

Screenshot showing workflow rename option and change account option

On the next page you’ll be able to choose the Team, Channel, or Chat that this notification will post to. Note if you are using this workflow from a chat or channel these fields will auto-populate for you. After filling out the required details, select Add workflow.

Once the workflow is created, you’ll see a new dialog with the URL that you can copy.

Screenshot showing a confirmation that a workflow has been added.

If you ever need to copy the workflow URL again, you’ll be able to find it by opening the Workflows app within Teams, selecting the workflow that was created, selecting Edit  Fluent 2 edit icon small, and expanding the trigger When a Teams webhook request is received. ​​​​​​​

Screenshot showing where to copy a specific workflow in the Workflows app.​​​​​​​

Set up an incoming webhook workflow from scratch

Screenshot showing where to find blank templates for workflows

  1. Select View more apps Microsoft Teams more options icon on the left side of Teams, then open Workflows Workflow logo.

  2. Go to the Create tab and select Create from blank next to the search bar.

  3. Use the search bar to search for the trigger When a Teams webhook request is received, and select it.

  4. Choose who can trigger the flow (authentication type). You can choose from three different authentication types:

    1. Anyone (this choice is unauthenticated)

    2. Any user in my tenant

    3. Specific users in my tenant

  5. You'll now need to add an action to your workflow. Select New step and choose the action Post card in chat or channel which comes from the Teams connector. 

  6. Now you'll choose where the information from the webhook gets posted. Select the dropdown field Post in and choose the location. After you choose the location of channel, group chat, or chat with flow bot, fill in the other required fields.

  7. Select Save below your workflow. Once saved, you can return to the When a Teams webhook is received box and copy your HTTP POST URL.

While setting up the webhook trigger, you can add optional conditions. Go to the trigger Menu Microsoft Teams more options icon and select Settings Settings button. Scroll to the bottom and select Add Cross icon at top of the screen under the Trigger Conditions section. This step is optional and not required for the workflow to run.

Learn more

Developer documentation for Teams webhook connector

Browse and add workflows in Microsoft Teams

​​​​​​​Add or run a workflow from a message

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.