Get in touch
or send us a question?
CONTACT

Post a workflow when a webhook request is received in 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.

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

Screenshot showing Channel menu with Workflows selected

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 tenant users
Screenshot showing workflow templates

Once the workflow opens, you have the option to 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 are 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.