Converting targets to webhooks

<div class="article-banners">
<div id="docs-wmp-link"><a href="https://support.zendesk.com/hc/en-us/articles/5411234991258-plan" rel="noopener noreferrer" target="_blank">What's my plan?</a></div>
<div class="article-banner" id="suite_all"><figure class="wysiwyg-table wysiwyg-table-align-left"><table><tbody><tr>
<td><strong>All Suites</strong></td>
<td>Team, Growth, Professional, Enterprise, or Enterprise Plus</td>
</tr></tbody></table></figure></div>
<div class="article-banner" id="support_all"><figure class="wysiwyg-table wysiwyg-table-align-left"><table><tbody><tr>
<td><strong>Support</strong></td>
<td>Team, Professional, or Enterprise</td>
</tr></tbody></table></figure></div>
</div><div class="body">
<div class="note">
<span class="notetitle">Note:</span> URL and branded targets were deprecated on December 13, 2024.</div>
<p class="p">Previously, <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408883282458" rel="noopener noreferrer" target="_blank">targets</a> have been used to pass information to external, cloud-based applications and services to notify them of changes in Zendesk. This article describes how to convert most existing targets you have into webhooks.</p>
<div class="p">
<p>This article includes the following topics:</p>
<ul class="ul" id="topic_pnd_pj1_czb__ul_xvy_xp1_czb">
<li class="li" data-list-item-id="eeed20cfc6a67686c24a188342805c5e2"><a class="xref" href="#topic_blf_yp1_czb">Create a new webhook based on your target</a></li>
<li class="li" data-list-item-id="ed1069edd934d96e91699b64073c5ca95"><a class="xref" href="#topic_wfb_dq1_czb">Configure a trigger to send the webhook notifications</a></li>
<li class="li" data-list-item-id="ef73b26ace7c4048c126063c45bd873f2"><a class="xref" href="#topic_qht_rq1_czb">Deactivate your target and associated triggers</a></li>
</ul>
</div>
</div><div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_c2v_dtq_tzb">
<h2 class="title topictitle2" id="ariaid-title2">About converting targets to webhooks</h2>
<div class="body"><div class="p">
<p>When converting targets into webhooks, the order of your actions matter for process continuity. We recommend the following process:</p>
<ol class="ol" id="topic_c2v_dtq_tzb__ol_ydd_c2r_tzb">
<li class="li" data-list-item-id="ead28772e4c0219a1a1ad3366b865a5f8">
<a class="xref" href="#topic_blf_yp1_czb">Create a new webhook</a> based on your target.</li>
<li class="li" data-list-item-id="e2e566cafca8b04cfa93befe5dbbe3c03">
<a class="xref" href="#topic_wfb_dq1_czb">Configure a trigger</a> to send the webhook notification.</li>
<li class="li" data-list-item-id="e9449bc2dce4a5236be613738ab9aca50">Verify the new webhook and trigger are working as expected, and then <a class="xref" href="#topic_qht_rq1_czb">deactivate your target</a> and any triggers associated with the target.</li>
</ol>
</div></div>
<div aria-labelledby="ariaid-title3" class="topic nested2" id="topic_ndg_jpx_tzb">
<h3 class="title topictitle3" id="ariaid-title3">Converting Clickatell, Pivotal, Twilio, X Corp, and Yammer targets</h3>
<div class="body"><p class="p">There's no direct way to map Clickatell, Pivotal, Twilio, X Corp (formerly Twitter), and Yammer target configurations to webhooks. We recommend looking into <a class="xref" href="https://www.zendesk.com/marketplace/" rel="noopener noreferrer" target="_blank">Zendesk Marketplace apps</a> that can meet your needs.</p></div>
</div>
</div><div aria-labelledby="ariaid-title4" class="topic nested1" id="topic_blf_yp1_czb">
<h2 class="title topictitle2" id="ariaid-title4">Create a new webhook based on your target</h2>
<div class="body">
<p class="p">To convert your targets into webhooks, you'll want to have the target's details open in one window and the webhook open in another.</p>
<p class="p"><strong class="ph b">To create a webhook based on a URL target</strong></p>
<ol class="ol" id="topic_blf_yp1_czb__ol_ttt_nr1_czb">
<li class="li" data-list-item-id="eb0f2ee15cc7b74bde898e061e3b23dd1">In a browser window, open the URL target.<ol class="ol" id="topic_blf_yp1_czb__ol_qyv_4s1_czb" type="a">
<li class="li" data-list-item-id="e0914f41939673ddaf36dd4bf6c7eadbf">
<span class="ph">In </span><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" rel="noopener noreferrer" target="_blank"><span class="ph">Admin Center</span></a><span class="ph">, click <img class="wysiwyg-image" id="topic_blf_yp1_czb__d7e1768" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_apps_integrations_icon.png"> <strong class="ph b">Apps and integrations</strong> in the sidebar, then select <strong class="ph b">Targets &gt; Targets</strong>.</span>
</li>
<li class="li" data-list-item-id="e922f937cb405d607155348cfb708501e">Find the target you want to convert to a webhook and click <strong class="ph b">Edit</strong>.</li>
</ol>
</li>
<li class="li" data-list-item-id="e9ef93519121ce2030b1f09308ce28ce2">In a separate browser window, open the Webhooks page.<ul class="ul" id="topic_blf_yp1_czb__ul_h2n_f4x_tzb"><li class="li" data-list-item-id="e976101c963fa422744395fa79b96a789">
<span class="ph">In </span><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" rel="noopener noreferrer" target="_blank"><span class="ph">Admin Center</span></a><span class="ph">, click <img class="wysiwyg-image" id="topic_blf_yp1_czb__d7e1738" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_apps_integrations_icon.png"> <strong class="ph b">Apps and integrations</strong> in the sidebar, then select <strong class="ph b">Actions and webhooks &gt; Webhooks</strong>.</span>
</li></ul>
</li>
<li class="li" data-list-item-id="e22d0f9a4e7fe8c58fb875e42bde527d4">Click <strong class="ph b">Create webhook</strong>.</li>
<li class="li" data-list-item-id="ee261a6d250a19809251d821d71156283">Select <strong class="ph b">Trigger or automation</strong> as the way to connect and click <strong class="ph b">Next</strong>.</li>
<li class="li" data-list-item-id="e5956803db23cad41fad9cacbf64da9a5">Map the target values to the webhook fields. For detailed mapping instructions, see:<ul class="ul" id="topic_blf_yp1_czb__ul_vqk_hnx_tzb">
<li class="li" data-list-item-id="e493e4f4db3558726dc2a11fab8bbe713"><a class="xref" href="#topic_tzm_4nx_tzb">Basecamp</a></li>
<li class="li" data-list-item-id="ee7ddd8d014441b80fd6bea410efffd1b"><a class="xref" href="#topic_g1f_h2r_tzb">Campfire</a></li>
<li class="li" data-list-item-id="efbfb8642de60c9c47cff99b57e081a29"><a class="xref" href="#topic_y1n_nnx_tzb">Get Satisfaction</a></li>
<li class="li" data-list-item-id="e544728105249875adb2ca5ddf38a02af"><a class="xref" href="#topic_bqx_qnx_tzb">Jira</a></li>
<li class="li" data-list-item-id="eac4986c736f35a033a7e141463baedcf"><a class="xref" href="#topic_udx_kmx_tzb">URL</a></li>
</ul>
</li>
<li class="li" data-list-item-id="e0848baf99c922c5843243861f6aaad5b">Click <strong class="ph b">Create webhook</strong>.</li>
</ol>
</div>
<div aria-labelledby="ariaid-title5" class="topic nested2" id="topic_tzm_4nx_tzb">
<h3 class="title topictitle3" id="ariaid-title5">Mapping Basecamp target configurations to webhooks</h3>
<div class="body"><div class="p">
<p>Map the Basecamp target values to the webhook fields as follows:</p>
<ul class="ul" id="topic_tzm_4nx_tzb__ul_cgp_qqx_tzb">
<li class="li" data-list-item-id="eb0061863b6395a4628fc73316a574e8f">
<strong class="ph b">Title</strong>: The webhook's <strong class="ph b">Name</strong>.</li>
<li class="li" data-list-item-id="e92434bc4102ea2727afd70d5d026b22d">
<strong class="ph b">URL</strong>: The webhook's <strong class="ph b">Endpoint URL</strong>.</li>
<li class="li" data-list-item-id="eff4fa73114a2624bb95cb112a14190eb">For the webhook's authentication, choose one of the following methods:<ul class="ul" id="topic_tzm_4nx_tzb__ul_v5r_wvg_vzb">
<li class="li" data-list-item-id="ed42f8312bf22f7f68ca7fec6ead85b3b">
<strong class="ph b">Username</strong> and <strong class="ph b">Password</strong>: Set the webhook's <strong class="ph b">Authentication</strong> to <strong class="ph b">Basic authentication</strong> and enter the Basecamp username and password. You can't copy and paste the password.</li>
<li class="li" data-list-item-id="e422255780d2f8d6abde46e470b7ecc90">
<strong class="ph b">API token</strong>: Set the webhook's <strong class="ph b">Authentication</strong> to <strong class="ph b">API key</strong> and enter the Campfire target's API token.</li>
</ul>
</li>
<li class="li" data-list-item-id="e75dad804d4e6dfc486510c475a00d58d">
<strong class="ph b">Project ID</strong>: Append to the end of the webhook's <strong class="ph b">Endpoint URL</strong> with <strong class="ph b">/projects/[ID]</strong>. Example: https://corp.basecamphq.com<strong class="ph b">/projects/2612430</strong>.</li>
<li class="li" data-list-item-id="e77460d9fe2a528b9cf0ecdb5f9360f45">
<strong class="ph b">Resources</strong>: Append to the end of the webhook's <strong class="ph b">Endpoint URL</strong>, following the project ID.<ul class="ul" id="topic_tzm_4nx_tzb__ul_oqv_bsx_tzb">
<li class="li" data-list-item-id="ea80d2db3af71c5f0cf7b9b990352b7d3">
<strong class="ph b">Message</strong>: Append with <strong class="ph b">/posts/[ID]/comments</strong>. Example: <code class="ph codeph">https://corp.basecamphq.com/projects/2612430<strong class="ph b">/posts/25611692/comments</strong></code>
</li>
<li class="li" data-list-item-id="edeff3d4ee0a11516cf2bdea5f683c514">
<strong class="ph b">To-do</strong>: Append with <strong class="ph b">/todo_lists/[ID]</strong>. Example: https://corp.basecamphq.com/projects/2612430<strong class="ph b">/todo_lists/25611692</strong>.</li>
</ul>
</li>
</ul>
</div></div>
</div>
<div aria-labelledby="ariaid-title6" class="topic nested2" id="topic_g1f_h2r_tzb">
<h3 class="title topictitle3" id="ariaid-title6">Mapping Campfire target configurations to webhooks</h3>
<div class="body"><div class="p">
<p>Map the Campfire target values to the webhook fields as follows:</p>
<ul class="ul" id="topic_g1f_h2r_tzb__ul_ctm_zt1_czb">
<li class="li" data-list-item-id="ef9900e887dbc1190509192504dbb5cf1">
<strong class="ph b">Title</strong>: The webhook's <strong class="ph b">Name</strong>.</li>
<li class="li" data-list-item-id="e9bf3bfbc6ba0f0ba6e54c200fb3f7d17">
<strong class="ph b">Subdomain</strong>: The webhook's <strong class="ph b">Endpoint URL</strong>.</li>
<li class="li" data-list-item-id="e03714151cd8d11f7960f7031288965c6">
<strong class="ph b">API Token</strong>: Set the webhook's <strong class="ph b">Authentication</strong> to <strong class="ph b">API key</strong> and enter the Campfire target's API token.</li>
<li class="li" data-list-item-id="e08adedbdbc0a3df829a35aa79b69012a">
<strong class="ph b">Room</strong>: Append this information to the webhook's <strong class="ph b">Endpoint URL</strong>.</li>
<li class="li" data-list-item-id="ed1f63506d90fe112499ff4d60c4c197d">
<strong class="ph b">SSL</strong>: This isn't applicable when creating a webhook.</li>
<li class="li" data-list-item-id="e1bc2d89348a9517a193dfcef29a7d058">
<strong class="ph b">Preserve format</strong>: This isn't applicable when creating the webhook.</li>
</ul>
</div></div>
</div>
<div aria-labelledby="ariaid-title7" class="topic nested2" id="topic_y1n_nnx_tzb">
<h3 class="title topictitle3" id="ariaid-title7">Mapping Get Satisfaction target configurations to webhooks</h3>
<div class="body"><div class="p">
<p>Map the Get Satisfaction target values to the webhook fields as follows:</p>
<ul class="ul" id="topic_y1n_nnx_tzb__ul_v3b_yyx_tzb">
<li class="li" data-list-item-id="e051908734ffaef30be41ae9f42953245">
<strong class="ph b">Title</strong>: The webhook's <strong class="ph b">Name</strong>.</li>
<li class="li" data-list-item-id="e711a4f3f204c878499c34d66e4fdaea5">
<strong class="ph b">Company Name</strong>: Incorporate into the webhook's <strong class="ph b">Endpoint URL</strong>. For example: <code class="ph codeph">https://getsatisfaction.com/<strong class="ph b">yourcompany</strong>/</code>
</li>
<li class="li" data-list-item-id="e4e0563f53685d7a9808f2cf2226c57bd">
<strong class="ph b">Email</strong> and <strong class="ph b">Password</strong>: Set the webhook's <strong class="ph b">Authentication</strong> to <strong class="ph b">Basic authentication</strong> and enter the Get Satisfaction username and password. You can't copy and paste the password.</li>
</ul>
</div></div>
</div>
<div aria-labelledby="ariaid-title8" class="topic nested2" id="topic_bqx_qnx_tzb">
<h3 class="title topictitle3" id="ariaid-title8">Mapping Jira target configurations to webhooks</h3>
<div class="body"><div class="p">
<p>Zendesk highly recomends using the <a class="xref" href="https://www.zendesk.com/marketplace/apps/support/1166950/jira" rel="noopener noreferrer" target="_blank">Jira app in the Zendesk Marketplace</a> to replace Jira targets. However, if you choose not to use the Jira app, you can map the Jira target values to the webhook fields as follows:</p>
<ul class="ul" id="topic_bqx_qnx_tzb__ul_lvm_qcy_tzb">
<li class="li" data-list-item-id="e4a15614e018b154b140db36efa86c2d7">
<strong class="ph b">Title</strong>: The webhook's <strong class="ph b">Name</strong>.</li>
<li class="li" data-list-item-id="e2aa45491a25e5edc124f8899e8a2fecc">
<strong class="ph b">URL</strong>: The webhook's <strong class="ph b">Endpoint URL</strong>.</li>
<li class="li" data-list-item-id="e6dddfc4ab6166f103dc62c38dba59943">
<strong class="ph b">Username</strong> and <strong class="ph b">Password</strong>: Set the webhook's <strong class="ph b">Authentication</strong> to <strong class="ph b">Basic authentication</strong> and enter the JIRA username and password. You can't copy and paste the password.</li>
</ul>
</div></div>
</div>
<div aria-labelledby="ariaid-title9" class="topic nested2" id="topic_udx_kmx_tzb">
<h3 class="title topictitle3" id="ariaid-title9">Mapping URL target configurations to webhooks</h3>
<div class="body"><div class="p">
<p>Map the URL target values to the webhook fields as follows:</p>
<ul class="ul" id="topic_udx_kmx_tzb__ul_vdx_kmx_tzb">
<li class="li" data-list-item-id="ed9f7fd8f42940fe558a99e578ed6a1c9">
<strong class="ph b">Title</strong>: The webhook's <strong class="ph b">Name</strong>.</li>
<li class="li" data-list-item-id="e21794051d397b4ec2f4c6a64d2367f46">
<strong class="ph b">URL</strong>: The webhook's <strong class="ph b">Endpoint URL</strong>.</li>
<li class="li" data-list-item-id="ec54ea32ccb14a7381184bd14d54cfa5d">
<strong class="ph b">Method</strong>: The webhook's <strong class="ph b">Request method</strong>.</li>
<li class="li" data-list-item-id="e04dc2c45415689bc27541f0391a0c059">
<strong class="ph b">Attribute name</strong>: This isn't required when creating the webhook, but will be used when configuring the trigger actions.</li>
<li class="li" data-list-item-id="e9de4028e418aa4d9b678ae77d319e88f">
<strong class="ph b">Basic authentication</strong>: Set the webhook's <strong class="ph b">Authentication</strong> to <strong class="ph b">Basic authentication</strong> and enter the URL target's username and password. You can't copy and paste the password.</li>
<li class="li" data-list-item-id="ea8cdf3f9df221e276ff9adc0ee66eac9">Additionally, in the webhook you need to set the <strong class="ph b">Request format</strong> to <strong class="ph b">Form encoded</strong>.</li>
</ul>
</div></div>
</div>
</div><div aria-labelledby="ariaid-title10" class="topic nested1" id="topic_wfb_dq1_czb">
<h2 class="title topictitle2" id="ariaid-title10">Configure a trigger to send the webhook notifications</h2>
<div class="body">
<p class="p">You should already have a trigger configured to send notifications based on the target. You can edit this trigger or clone it, or you can create a new trigger.</p>
<div class="p">
<p><strong class="ph b">To edit an existing trigger to send the webhook notification</strong></p>
<ol class="ol" id="topic_wfb_dq1_czb__ol_md3_tw1_czb">
<li class="li" data-list-item-id="eb697e6d6f0b5a99232c08256c35d7129">
<span class="ph">In </span><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" rel="noopener noreferrer" target="_blank"><span class="ph">Admin Center</span></a><span class="ph">, click <img class="wysiwyg-image" id="topic_wfb_dq1_czb__d7e1292" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_objects_rules_icon.png"> <strong class="ph b">Objects and rules</strong> in the sidebar, then select <strong class="ph b">Business rules &gt; Triggers</strong>.</span>
</li>
<li class="li" data-list-item-id="e3dbdba607757659a7e5e1f2dda66408c">
<p><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408882237722#topic_dwq_zoy_tb" rel="noopener noreferrer" target="_blank">Edit or clone an existing trigger</a>.</p>
<p class="p">Note the <strong class="ph b">Message</strong> value for the <strong class="ph b">Notify by &gt; Target</strong> action. You'll re-use this with your new webhook-based action.</p>
</li>
<li class="li" data-list-item-id="e546cdfcd41f8b88f92b9870dba8c463b">Under <strong class="ph b">Actions</strong>, click <strong class="ph b">Add action</strong> and select <strong class="ph b">Notify by &gt; Active webhook</strong>.</li>
<li class="li" data-list-item-id="ec5a7bd178b102d2fece8fae645514876">Select the webhook you created to replace the target from the dropdown.</li>
<li class="li" data-list-item-id="e625eae7b8cf6f123825353c15a2e9a63">
<p>Configure the webhook to send the information you need to.</p>
<p class="p">For example, if replacing a URL target, under <strong class="ph b">URL parameters</strong>, you'd do the following:</p>
<ul class="ul" id="topic_wfb_dq1_czb__ul_s3t_jz1_czb">
<li class="li" data-list-item-id="e2a5662cf8184199fcf3d4772b85ed1a7">Set the <strong class="ph b">key</strong> to the URL target's <strong class="ph b">Attribute name</strong>.</li>
<li class="li" data-list-item-id="efe2eb6f7557b67a56ee03726da242d9c">Set the <strong class="ph b">value</strong> to the <strong class="ph b">Notify by &gt; Target</strong> action's <strong class="ph b">Message</strong>.</li>
</ul>
</li>
<li class="li" data-list-item-id="e1b93a8c0168dfe4f700b32b1d2a173f8">Click <strong class="ph b">Save</strong>.</li>
<li class="li" data-list-item-id="e6a703c8c6fe9db11b6c78fc56fe734b8">Return to the webhook and test the functionality.</li>
</ol>
</div>
</div>
</div><div aria-labelledby="ariaid-title11" class="topic nested1" id="topic_qht_rq1_czb">
<h2 class="title topictitle2" id="ariaid-title11">Deactivate your target and associated triggers</h2>
<div class="body">
<p class="p">After you create the webhook and update the associated trigger, thoroughly <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408839108378#topic_ijl_fcx_dpb" rel="noopener noreferrer" target="_blank">test the webook</a> by initiating the appropriate trigger conditions. While the trigger is configured with two <strong class="ph b">Notify by</strong> actions, one for the target and another for the webhook, you should receive duplicate messages on your external application or system.</p>
<p class="p">After you confirm the webhook and trigger are working properly, <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408882237722#topic_dwq_zoy_tb" rel="noopener noreferrer" target="_blank">edit the trigger</a> to remove the <strong class="ph b">Notify by &gt; Target</strong> action and then <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408835069978" rel="noopener noreferrer" target="_blank">deactivate or delete your target</a>.</p>
</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/6255324672154",
"url": "https://support.zendesk.com/hc/en-us/articles/6255324672154-Converting-targets-to-webhooks",
"headline": "Converting targets to webhooks",
"description": "You can convert deprecated targets into webhooks by creating a new webhook based on the target, configuring a trigger to send webhook notifications, and then deactivating the original target and associated triggers after testing.",
"articleSection": "Extending Zendesk",
"datePublished": "2023-10-12T21:02:46+00:00",
"dateModified": "2026-02-24T17:55:12+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/6255324672154"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"@id": "https://support.zendesk.com/hc/"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
}
}</script>