Replace a Jira webhook URL and secret
A Jira connection that signs in with an API token gets its issues through a webhook in Jira. Jaah shows the URL and secret of the webhook only once. Make a new pair when you lost them, when the secret leaked, or when the connection's webhook state is Old address or Missing.
Who can do this: Owners and Admins of your organization. Nobody else sees Issue trackers. Changing the webhook in Jira needs a Jira site admin.
This works only for a Jira connection whose Sign-in is API token. Linear, Backlog and Jaah's Jira app keep their own webhooks, so their page has no New webhook URL.
Make the new pair
The old URL and secret stop working the moment you confirm. Have Jira's webhook settings open first, so no events are lost in between.
- In the sidebar, select Settings, then Integrations, then Issue trackers.
- Select the Jira connection's name. Its page opens on the Connection tab.
- Select New webhook URL.
- New webhook URL? asks you to confirm. Select New webhook URL again. Select Cancel to keep the old pair.
- A dialog named after the connection, such as Jira · acme.atlassian.net: new webhook, shows the URL and the Secret. Keep it open until both are in Jira: it does not show them again.
Paste them into Jira
- In Jira, open Settings › System › WebHooks.
- Open the webhook that sends to Jaah and edit it.
- In Jaah, select Copy URL. Paste it into the URL of the webhook in Jira.
- In Jaah, select Copy secret. Paste it into the Secret of the webhook in Jira.
- Save the webhook in Jira.
- In Jaah, select Done.
- Reload the connection's page. In the Webhook section, the site's row should read Working.
If you lost the pair before pasting both, make another one. Each new pair replaces the last.
Related
- Fix a tracker webhook that isn't working: read the Webhook section's states and what each needs.
- Start tasks from Jira: the first webhook setup, with the events to tick.
- Check what a tracker did with an issue: check an event arrives after the change.
- Issue trackers: every field on the Connection tab.