Jira Inbound Webhook

Configure a Jira inbound webhook so Xyte can trigger Jira automation rules for incident create, update, and close events.

Overview

Configure a Jira inbound webhook so Xyte can trigger Jira automation rules when device events create, update, or close incidents.


How it works

Jira's Incoming webhook trigger listens for an HTTP POST sent to a unique webhook URL. When Xyte sends a request to that URL, Jira runs the automation rule associated with it — for example, creating an incident in a Jira Service Management project.

In this flow, Jira receives webhook events from Xyte.


Step 1 — Create an automation rule in Jira

  1. In Jira, go to Project Settings → Automation (or Global Automation for cross-project rules)
  2. Click Create rule
  3. Select Incoming webhook as the trigger
  4. Jira generates a unique Webhook URL and Secret — copy both

The webhook URL looks like: https://api-private.atlassian.com/automation/webhooks/jira/a/<rule-id>/...

  1. Under Work item criteria, select No work items from the webhook unless you want Xyte to pass issue keys
  2. Add your actions (e.g. Create incident in your Jira Service Management project)
  3. Save and Enable the rule

Step 2 — Configure the inbound webhook in Xyte

  1. In Xyte, go to Integrations → Webhooks
  2. Paste the Jira webhook URL into the Create incident URL, Update incident URL, and Close incident URL fields you want to use
  3. Check Add custom header to requests
  4. Under Custom Header, set:
FieldValue
Field nameX-Automation-Webhook-Token
Field valueThe Jira webhook secret copied in Step 1
  1. Leave Add custom parameter to requests and Send payload as string unchecked unless specifically required
  2. Save the configuration

Troubleshooting

If the webhook shows Error or the automation rule shows Some errors in the Jira audit log, check the following:

IssueWhat to check
Rule shows "Some errors" in audit logOpen the audit log entry in Jira and expand the Incoming webhook step to see the error detail
"No issues from the webhook" in audit logExpected if you selected No work items from the webhook in the trigger configuration — the rule still runs normally
Webhook not firingConfirm the rule is Enabled in Jira and the correct URL is pasted in Xyte
Authentication errorMake sure the X-Automation-Webhook-Token header value exactly matches the secret shown in the Jira trigger configuration

Additional resources