Skip to main content
Skip table of contents

How to create Incoming Webhook URL?

Generate Incoming webhook URL

Please note, due to the upcoming retirement of Incoming Webhook connector in Microsoft Teams, you must use the Workflows app to generate webhook URLs to receive notifications in Microsoft Teams channels.

Workflows app URLs support is available since 7.14.32.

How to create webhook URL with Workflows app?

To generate an Incoming webhook in Microsoft Teams, follow these steps:

  1. Open Microsoft Teams and navigate to the channel where you want to add the Incoming webhook.

  2. Click on the three dots (...) next to the channel's name and select Connectors from the dropdown menu.

    1. If you use the updated version of Microsoft Teams you should go to Manage channel section and click on Edit next to Connectors.

      image-20240130-170950.png
  3. In the Connectors window, search for "Incoming Webhook" and click on it.

  4. Click on the Configure button to add a new Incoming Webhook URL.

  5. Give your webhook a name and, optionally, upload an icon for it.

  6. Click on the Create button to create the incoming webhook.

  7. Copy the webhook URL that is generated. This URL is unique to your webhook and will be used to send messages to a particular channel.

  8. Click on the Done button to finish creating the incoming webhook.

In case the connector wasn’t added to the particular channel before instead of the button Configure you will see the button Add. Add the connector to the channel and repeat all the steps from points 4-8.

Once Incoming Webhook URL is generated, you can:

  • insert it straight into Where to deliver section (notification/alert/report creation modal window):

  • save it for other team members on the Managed URLs tab on the Global and Project levels.

Managed Webhook URLs

With Webhook URLs management, you can configure named Microsoft Teams Incoming Webhook URLs and optionally restrict them to particular Jira projects.

Please note, the Webhook URLs management is available only for Jira global and project admins.

Managed URLs are useful for several reasons:

  • simplified Webhook URL creation;

  • you can identify URLs by name, which provides much more flexibility to administer;

  • restrictions by the Jira project enable your project admins to use them without asking for a new URL.

For instance, you can create a URL for the “Customer Success” team and permit them to use it only by the Customer Success Jira project. It means that during the notification rule creation in Where to deliver section this URL will be avaible only for Customer Success project.

To create a new Managed Url follow these steps:

  1. Open app settings on Global or Project level.

  2. Go to Webhook Url Management tab.

    image-20240130-172622.png
  3. Click on Create button.

  4. Insert the Incoming Webhook URL you generated (see the instruction above) and indicate the rest parameters.

    image-20240130-172704.png
  5. Click on Save.

  6. To use this Webhook URL you need to switch on the toggle Use Managed URL and select the URL you need from the dropdown below (Webhook name).

    image-20240130-173004.png

Important: The restriction by project for a particular Incoming Webhook URL works only on project level. On Global level Jira admin can use all created Webhook URLs.


Notifications to the Microsoft Teams channel

Scheduled reports and alerts

Admin events notifications

Troubleshooting

Updated:

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.