---
sourceDocument: Australia IT Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/it-service-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Configure and test webhooks

# Configure and test webhooks {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read  
Manually configure webhooks in Azure DevOps and test them.

## Configure webhooks in Azure DevOps manually {#ariaid-title2}

Configure webhooks in Azure DevOps to send sync notifications to the DevOps Change Velocity application.

### Before you begin

Role required: sn_devops.admin or sn_devops.tool_owner in DevOps Change Velocity, Azure DevOps admin

### About this task

You can also access manual configuration from the Azure DevOps tool record in DevOps Change Velocity.

### Procedure

1. In Azure DevOps, open the project for which you are configuring webhooks.
2. Navigate to SettingsService Hooks and create a NEW SERVICE HOOKS SUBSCRIPTION, in Azure DevOps.
3. In DevOps Change Velocity, choose Configure manually when configuring the tool instance to send data.  
4. In DevOps Change Velocity, copy the Webhook URL field from the ServiceNow instance connection details for Azure DevOps.  
   Note:  
   Select Copy in the appropriate field to copy the value to your clipboard. The field label changes to Copied, but you can copy multiple times.
5. Modify the copied Webhook URL to reflect your tool details, and paste the URL in Azure DevOps.  
   For example:

   <kbd class="ph userinput">https://myinstance.service-now.com/api/sn_devops/v2/devops/tool/{code | plan | artifact | orchestration | test | softwarequality }?toolId=23410545938c71d0db5bfe686cba1036&amp;projectId=&lt;project_sys_id&gt;</kbd>
   1. Select one of the tool capabilities <kbd class="ph userinput">{code | plan | artifact | orchestration | test | softwarequality }</kbd> to match your tool.  
      For example:

      <kbd class="ph userinput">https://myinstance.service-now.com/api/sn_devops/v2/devops/tool/orchestration?toolId=23410545938c71d0db5bfe686cba1036&amp;projectId=&lt;project_sys_id&gt;</kbd>
   2. Replace <kbd class="ph userinput">&lt;project_sys_id&gt;</kbd> with your Azure DevOps project ID in ServiceNow (native_id column in the sn_devops_project table).
   3. Copy the modified URL to the URL field of the NEW SERVICE HOOKS SUBSCRIPTION in Azure DevOps.
6. In DevOps Change Velocity, copy the Secret token field from the ServiceNow instance connection details for Azure DevOps.
7. In Azure DevOps, in Header field of the NEW SERVICE HOOKS SUBSCRIPTION, paste the copied Secret token in the correct format.
   1. Use this format for the Azure DevOps HTTP headers field:  
      "<kbd class="ph userinput">token : &lt;tokenValue&gt;</kbd>"
   2. Replace <kbd class="ph userinput">&lt;tokenValue&gt;</kbd>, with the copied Secret token from the ServiceNow instance connection details for Azure DevOps.

   {#config-webhooks-azure-manually__table_ydl_d5n_dyb__entry__2}

   | From DevOps Change Velocity field | To Azure DevOps field |
   |-|-|
   | Webhook URL (modified) | URL |
   | Secret token | HTTP headers In the format: <kbd class="ph userinput">token : &lt;tokenValue&gt;</kbd> |
   [Table 1. Copy field values]

   {#config-webhooks-azure-manually__table_ydl_d5n_dyb}

## Test webhooks in Azure DevOps {#ariaid-title3}

You can manually test if webhooks are configured correctly directly from Azure DevOps for each project.

### Before you begin

Role required: Azure DevOps admin privileges

### Procedure

1. Navigate to Azure DevOps and select the project for which you want to test webhooks.
2. Navigate to Project settingsService hooks.  
   For each project, DevOps Change Velocity creates webhooks for these events:
   * Build completed
   * Code pushed
   * Release created
   * Release deployment completed
   * Run stage state changed
   * Work item created
   * Work item deleted
   * Work item restored
   * Work item updated
   {#test-wehooks-azure__ul_dmx_25z_syb}
3. Select a webhook and select Edit.
4. Select Next to see the URL and authentication details.  
5. To test the webhook, select Test.
   * If the webhook is configured correctly, you'll receive a Succeeded message.

   * If the webhook is configured incorrectly, you'll receive a Failed message.

     To fix a webhook, you can try the following options:
     * Reconfigure the webhooks by selecting Configure from the project record page in DevOps Change Velocity. This will reconfigure all the existing webhooks for the project.
     * Verify if the toolId and projectId are correct in the URL field. You can find the correct values in the tool record page in DevOps
       Change Velocity.

     * If you're using the integration user credentials for authentication, check if the credentials are correct in the Basic authentication username and password fields.

     * If you're using the secret token for authentication, the token value is masked in the Basic authentication password field. You can replace the token in this field.

     {#test-wehooks-azure__ul_qpy_f41_tyb}
   {#test-wehooks-azure__choices_wmt_3g1_tyb}

*[\>]: and then