zulip/zerver/webhooks/jira/doc.md

Get Zulip notifications for your JIRA projects!

These instructions apply to Atlassian Cloud's hosted JIRA, and JIRA Server version 5.2 or greater. For older installs, you'll need our JIRA Plugin.

1. {!create-stream.md!}

2. {!create-bot-construct-url-indented.md!}

3. Go to your JIRA Site administration page. Click Jira on the left. On the left sidebar, scroll down, and under Advanced, click WebHooks. Click + Create a WebHook.

4. Set Name to a name of your choice, such as Zulip. Set Status to Enabled, and set URL to the URL constructed above. Select the events you'd like to be notified about, and click Create. We only support the following Issue events:

   • when an issue is created
   • when an issue is deleted
   • when an issue is updated

   !!! tip "" If you'd like to be notified of issue comments, you should enable Issue updates; Zulip ignores Jira's webhook Comment events as they are redundant with the Issue events and do not have complete information in some versions of Jira.

{!congrats.md!}