<h2>Configure webhooks in Azure DevOps manually</h2><br/><div style="overflow-x:auto"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head><meta content="text/html; charset=UTF-8" /><meta name="copyright" content="(C) Copyright 2024" /><meta name="DC.rights.owner" content="(C) Copyright 2024" /><meta name="generator" content="DITA-OT" /><meta name="DC.type" content="task" /><meta name="DC.title" content="Configure webhooks in Azure DevOps manually" /><meta name="abstract" content="Configure webhooks in Azure DevOps to send sync notifications to the DevOps Change Velocity application." /><meta name="description" content="Configure webhooks in Azure DevOps to send sync notifications to the DevOps Change Velocity application." /><meta name="DC.relation" scheme="URI" content="../../../product/enterprise-dev-ops/concept/azure-devops-integration-dev-ops.html" /><meta name="DC.relation" scheme="URI" content="../../../product/enterprise-dev-ops/concept/dev-ops-bundle-landing-page.html" /><meta name="DC.relation" scheme="URI" content="../../../product/enterprise-dev-ops/concept/devops-landing-page-new.html" /><meta name="DC.relation" scheme="URI" content="../../../product/enterprise-dev-ops/concept/integrating-devops-change-with-third-party-tools.html" /><meta name="DC.creator" content="Pratima Mahtani" /><meta name="DC.creator" content="Lisa Hultman" /><meta name="DC.creator" content="ServiceNow" /><meta name="DC.date.created" content="2023-07-16T19:50:49-07:00" /><meta name="DC.date.modified" content="2024-02-01" /><meta name="DC.format" content="XHTML" /><meta name="DC.identifier" content="config-webhooks-azure-manually" /><link rel="stylesheet" type="text/css" href="../../../CSS/commonltr.css" /><title>Configure webhooks in Azure DevOps manually</title></head><body id="config-webhooks-azure-manually"> <div class="breadcrumb"><a class="link" href="../../../product/enterprise-dev-ops/concept/dev-ops-bundle-landing-page.html" title="Use the ServiceNow DevOps application with your DevOps toolchain to provide data insights, accelerate change, increase development performance, validate configuration data, and increase the visibility of your DevOps environment using a single system.">DevOps</a> > <a class="link" href="../../../product/enterprise-dev-ops/concept/devops-landing-page-new.html" title="With ServiceNow DevOps Change Velocity, you can import data from your DevOps tool chain to the ServiceNow platform and deliver changes faster without sacrificing compliance.">DevOps Change Velocity</a> > <a class="link" href="../../../product/enterprise-dev-ops/concept/integrating-devops-change-with-third-party-tools.html" title="Integrate your orchestration, planning, coding, artifact, software quality, and security tools with DevOps Change Velocity for end to end change traceability and automation.">Integrating DevOps Change Velocity with third-party tools</a> > </div> <h1 class="title topictitle1" id="ariaid-title1">Configure webhooks in <span class="ph">Azure DevOps</span> manually</h1> <div class="body taskbody"><p class="shortdesc">Configure webhooks in <span class="ph">Azure DevOps</span> to send sync notifications to the <span class="ph">DevOps Change Velocity</span> application.</p> <div class="section prereq p"> <p class="p">Role required: sn_devops.admin or sn_devops.tool_owner in <span class="ph">DevOps Change Velocity</span>, <span class="ph">Azure DevOps</span> admin</p> </div> <div class="section context" id="config-webhooks-azure-manually__context_jvx_d4j_2yb"> <p class="p">You can also access manual configuration from the <span class="ph">Azure DevOps</span> tool record in <span class="ph">DevOps Change Velocity</span>.</p> </div> <ol class="ol steps"><li class="li step stepexpand"> <span class="ph cmd">In <span class="ph">Azure DevOps</span>, open the project for which you are configuring webhooks.</span> </li><li class="li step stepexpand"> <span class="ph cmd">Navigate to <span class="ph menucascade"><span class="ph uicontrol">Settings</span> > <span class="ph uicontrol">Service Hooks</span></span> and create a NEW SERVICE HOOKS SUBSCRIPTION, in <span class="ph">Azure DevOps</span>.</span> </li><li class="li step stepexpand"> <span class="ph cmd">In <span class="ph">DevOps Change Velocity</span>, choose <span class="ph uicontrol">Configure manually</span> when configuring the tool instance to send data.</span> <div class="itemgroup info"><img class="image" id="config-webhooks-azure-manually__image_owh_vsv_2yb" src="../image/azure-plybk-13.png" alt="Azure DevOps configuring tool" /></div> </li><li class="li step stepexpand"> <span class="ph cmd">In <span class="ph">DevOps Change Velocity</span>, copy the <span class="ph uicontrol">Webhook URL</span> field from the ServiceNow instance connection details for <span class="ph">Azure DevOps</span>.</span> <div class="itemgroup info"><div class="note"><span class="notetitle">Note:</span> Select <span class="ph uicontrol">Copy</span> in the appropriate field to copy the value to your clipboard. The field label changes to <span class="ph uicontrol">Copied</span>, but you can copy multiple times.</div> <img class="image" id="config-webhooks-azure-manually__image_f1h_lhn_dyb" src="../image/azure-manual-webhooks-3.png" alt="Azure DevOps configure webhooks manually" /></div> </li><li class="li step stepexpand"> <span class="ph cmd">Modify the copied Webhook URL to reflect your tool details, and paste the URL in <span class="ph">Azure DevOps</span>.</span> <div class="itemgroup info"> <p class="p">For example:</p> <p class="p">https://myinstance.service-now.com/api/sn_devops/v2/devops/tool/{code | plan | artifact | orchestration | test | softwarequality }?toolId=23410545938c71d0db5bfe686cba1036&projectId=<project_sys_id></p> </div> <ol type="a" class="ol substeps"><li class="li substep substepexpand"> <span class="ph cmd">Select one of the tool capabilities {code | plan | artifact | orchestration | test | softwarequality } to match your tool.</span> <div class="itemgroup info">For example:<p class="p">https://myinstance.service-now.com/api/sn_devops/v2/devops/tool/orchestration?toolId=23410545938c71d0db5bfe686cba1036&projectId=<project_sys_id></p> </div> </li><li class="li substep substepexpand"> <span class="ph cmd">Replace <project_sys_id> with your <span class="ph">Azure DevOps</span> project ID.</span> </li><li class="li substep substepexpand"> <span class="ph cmd">Copy the modified URL to the <span class="ph uicontrol">URL</span> field of the NEW SERVICE HOOKS SUBSCRIPTION in <span class="ph">Azure DevOps</span>.</span> </li></ol> </li><li class="li step stepexpand"> <span class="ph cmd">In <span class="ph">DevOps Change Velocity</span>, copy the <span class="ph uicontrol">Secret token</span> field from the ServiceNow instance connection details for Azure DevOps.</span> </li><li class="li step stepexpand"> <span class="ph cmd">In <span class="ph">Azure DevOps</span>, in <span class="ph uicontrol">Header</span> field of the NEW SERVICE HOOKS SUBSCRIPTION, paste the copied <span class="ph uicontrol">Secret token</span> in the correct format.</span> <ol type="a" class="ol substeps"><li class="li substep substepexpand"> <span class="ph cmd">Use this format for the <span class="ph">Azure DevOps</span> <span class="ph uicontrol">HTTP headers</span> field:</span> <div class="itemgroup info">"token : <tokenValue>"</div> </li><li class="li substep substepexpand"> <span class="ph cmd">Replace <tokenValue>, with the copied <span class="ph uicontrol">Secret token</span> from the ServiceNow instance connection details for <span class="ph">Azure DevOps</span>.</span> </li></ol> <div class="itemgroup stepresult"> <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="config-webhooks-azure-manually__table_ydl_d5n_dyb" class="table" frame="border" border="1" rules="all"><caption><span class="tablecap"><span class="table--title-label">Table 1. </span>Copy field values</span></caption><colgroup><col style="width:50%" /><col style="width:50%" /></colgroup><thead class="thead" style="text-align:left;"><tr class="row"><th class="entry cellrowborder" style="vertical-align:top;" id="d144667e293">From <span class="ph">DevOps Change Velocity</span> field</th><th class="entry cellrowborder" style="vertical-align:top;" id="d144667e299">To <span class="ph">GitHub</span> field</th></tr></thead><tbody class="tbody"><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d144667e293 ">Webhook URL (modified)</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d144667e299 ">URL</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d144667e293 ">Secret token</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d144667e299 "> <p class="p">HTTP headers</p> <p class="p">In the format:</p> <p class="p">token : <tokenValue></p> </td></tr></tbody></table> </div> <img class="image" id="config-webhooks-azure-manually__image_rsm_p1n_dyb" src="../image/azure-manual-webhooks.png" alt="Azure DevOps configure webhooks manually" /></div> </li></ol> </div> <div class="related-links"> <div class="familylinks"> <div class="parentlink"><strong>Parent Topic:</strong> <a class="link" href="../../../product/enterprise-dev-ops/concept/azure-devops-integration-dev-ops.html" title="Connect to your Azure DevOps instance to discover boards, repositories, and pipelines to enable change automation and traceability.">Azure DevOps integration with DevOps Change Velocity</a></div> </div> </div></body></html></div>