Configuring a Jira Cloud webhook for field syncing

<body>
<p id="docs-hc-snippet" style="display: none;">When saving field mappings to turn on field syncing, the Zendesk Support for Jira integration registers a Jira webhook. The webhook is triggered whenever a linked issue is updated, moved, or deleted by a user, informing the integration that data has changed and syncing may be required.</p>
<div class="article-banners">
<div id="docs-wmp-link">
<a href="https://support.zendesk.com/hc/en-us/articles/5411234991258-plan" rel="noopener" target="_blank">What's my plan?</a>
</div>

<div class="article-banner" id="suite_all">
<table>
<tbody>
<tr>
<td>
<strong>All Suites</strong>
</td>
<td>Team, Growth, Professional, Enterprise, or Enterprise Plus</td>
</tr>
</tbody>
</table>
</div>

<div class="article-banner" id="support_all">
<table>
<tbody>
<tr>
<td>
<strong>Support</strong>
</td>
<td>Team, Professional, or Enterprise</td>
</tr>
</tbody>
</table>
</div>

</div>
<div id="docs-ai-summary">
<p id="docs-ai-summary-toggle">Summary: <span id="up-triangle">◀</span><span id="down-triangle">▼</span></p>
<p id="docs-ai-summary-content">You need to manually create a Jira webhook to enable field syncing for linked issues. This webhook triggers updates when issues are changed or deleted, ensuring data stays synchronized. Setting it up requires admin access in Jira to configure the webhook with a specific URL and event settings, allowing your integration to detect and sync changes effectively.</p>
</div>

<div class="body">

<p class="p">When saving field mappings to turn on field syncing, the Zendesk Support for Jira
integration registers a Jira webhook. The webhook is triggered whenever a linked issue
is updated, moved, or deleted by a user, informing the integration that data has changed
and syncing may be required.</p>
<p class="p">Jira Cloud doesn't automatically create webhooks by third-party add-ons like Zendesk
Support for Jira. Jira administrators must manually create a webhook for field syncing
to work properly.</p>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_xmz_vxc_2jc">
<h2 class="title topictitle2" id="ariaid-title2">Configuring a Jira webhook</h2>
<div class="body">
<p class="p">Follow these steps to configure a Jira webhook for field syncing.</p>
<p class="p"><strong class="ph b">To configure a Jira webhook</strong></p>
<ol class="ol" id="topic_xmz_vxc_2jc__ol_dfk_yxc_2jc">
<li class="li">Sign in to Jira as an admin.</li>
<li class="li">In the top navigation bar, select <strong class="ph b">Apps</strong> &gt; <strong class="ph b">Manage your apps</strong>.</li>
<li class="li">Select <strong class="ph b">Zendesk Support for JIRA</strong> in the accordion, then click
<strong class="ph b">Configure</strong>.</li>
<li class="li">Select <strong class="ph b">Field Mapping</strong> in the left navigation pane, then click <strong class="ph b">Copy
webhook URL to clipboard</strong>.</li>
<li class="li">Click the <strong class="ph b">Settings</strong> cog icon, and under Jira Settings, click
<strong class="ph b">System</strong>.</li>
<li class="li">Select <strong class="ph b">Advanced</strong> &gt; <strong class="ph b">WebHooks</strong> in the left navigation menu.</li>
<li class="li">Click <strong class="ph b">Create a WebHook</strong> in the upper-right area of the screen.</li>
<li class="li">Enter the following information:<ul class="ul" id="topic_xmz_vxc_2jc__ul_v1m_3yc_2jc">
<li class="li">
<strong class="ph b">Name</strong>: Enter <code class="ph codeph">(Zendesk add-on) Sync with Zendesk on issue
update (do not change)</code>
</li>
<li class="li">
<strong class="ph b">Status</strong>: Select <strong class="ph b">Enabled</strong>
</li>
<li class="li">
<strong class="ph b">URL</strong>: Enter the webhook URL that you previously copied in Step 3.
We have provided a convenient mechanism to get the webhook URL with all
placeholders replaced with the correct values for your Zendesk
account.</li>
<li class="li">
<strong class="ph b">Events</strong>: <code class="ph codeph">labels = jira_escalated</code>
</li>
<li class="li">
<strong class="ph b">Issue</strong>: Select <strong class="ph b">updated</strong> and <strong class="ph b">deleted</strong><p class="p"><img class="image img-screenshot" id="topic_xmz_vxc_2jc__image_bgr_qmj_zp" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/jira_integration_issue_events.png" width="450"></p>
</li>
<li class="li">
<strong class="ph b">Exclude body</strong>: Do not select this option.</li>
</ul>
</li>
<li class="li">Click <strong class="ph b">Save</strong>. The Webhooks page displays the webhook details.</li>
</ol>
</div>
</div>
<script id="docs-schema-markup" type="application/ld+json">{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/10687180502810-Configuring-a-Jira-Cloud-webhook-for-field-syncing",
"url": "https://support.zendesk.com/hc/en-us/articles/10687180502810-Configuring-a-Jira-Cloud-webhook-for-field-syncing",
"headline": "Configuring a Jira Cloud webhook for field syncing",
"description": "You can configure a Jira webhook by manually creating it in Jira settings to enable field syncing triggered by issue updates or deletions for integration purposes.",
"articleSection": "Jira integration",
"datePublished": "2026-05-06T22:08:26+00:00",
"dateModified": "2026-05-07T16:13:56.136015+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/10687180502810-Configuring-a-Jira-Cloud-webhook-for-field-syncing"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"url": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"url": "https://support.zendesk.com/hc/en-us"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk"
}
}</script><script id="ai-summary-script">
//<![CDATA[
const ai_summary_style = document.createElement('style');
ai_summary_style.innerHTML = `#styled-article-body{padding:0 0 0}#article-body #docs-ai-summary{background-color:#f3f3f3;border:1px solid #d3d3d3;padding:10px 10px 6px;margin-bottom:16px}#article-body #docs-ai-summary #docs-ai-summary-toggle{font-size:.9em;font-weight:700;margin-bottom:4px;cursor:pointer;display:flex;justify-content:space-between;align-items:center}#article-body #docs-ai-summary #docs-ai-summary-toggle #up-triangle{margin-left:auto;padding-right:10px;display:none}#article-body #docs-ai-summary #docs-ai-summary-toggle #down-triangle{margin-left:auto;padding-right:10px}#article-body #docs-ai-summary #docs-ai-summary-content{font-size:.9em;padding-left:25px;padding-right:25px;margin-bottom:12px}`;
document.head.appendChild(ai_summary_style);

const toggleAISummary = () => {
const summary = document.getElementById("docs-ai-summary-content");
const upTriangle = document.getElementById("up-triangle");
const downTriangle = document.getElementById("down-triangle");
if (summary.style.display === "none") {
summary.style.display = "block";
upTriangle.style.display = "none";
downTriangle.style.display = "inline";
} else {
summary.style.display = "none";
upTriangle.style.display = "inline";
downTriangle.style.display = "none";
}
};

document.getElementById("docs-ai-summary-toggle").addEventListener("click", toggleAISummary);
//]]>
</script>
</body>