/
Creating Jira Webhooks

Creating Jira Webhooks

Starting October 11, 2024 (Zephyr Enterprise 8.2), the Zephyr Enterprise documentation moved from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise documentation page. Please see: https://support.smartbear.com/zephyr-enterprise/docs/en/zephyr-enterprise/zephyr-administration-guides/system-setup/jira-integration/setting-up-jira-integration/creating-jira-webhooks.html

Webhooks are an essential part of Zephyr integration with Jira. They are used to synchronize Zephyr and Jira requirements and information about defects.

Webhooks can be created in two ways:

  • Zephyr creates a pre-configured webhook automatically when you are mapping a project in Zephyr. In this case, there is no need to perform any additional actions. Later, you can update the created webhook, if needed.

  • You, as an administrator, can create and manage webhooks manually. This can be useful if you do not have (or do not want to create) a Jira service account with permissions required for automatic webhook management.

This topic describes how to create webhooks manually.

Create a webhook manually

Before creating a webhook, you need to map your Zephyr project to a Jira project. In this case, Zephyr will generate a JQL query you will use when creating a webhook. To map a Jira project to your Zephyr project, select the needed Jira project from the Map external Defect project dropdown when creating or editing your Zephyr project. For more information, see Adding a Project.

Steps to perform in Zephyr

  1. Log in to Zephyr as an administrator (Test Manager).

  2. Navigate to Administration > System Setup > Jira Integration: