Configure a webhook in Visual Studio GIT Enterprise

A. Create a Webhook API token from ARM

  1. Log in to ARM.

  2. Click on Admin Section -> API Token.

  3. Click on Create API Token.

  1. Enter the token name.

  2. Select Type as “webhook.”

  3. Enter Description if required.

  4. Click on Create Option.

  1. Your New API Token is created.

B. Create a Webhook with authentication on Visual Studio Git

  1. Log in to Microsoft Visual Studio Git Account

  2. Go to your project Service Hooks page:

    https://{orgName}/{projectname}/settings/serviceHooks

  1. Click on Create Subscription.

  2. The wizard will start and give a list of all the services for which integration is to be created.

  1. Click on Next and you will see a list of triggers when an event occurs. Select the event to initiate the trigger on and any filters (if applicable):

  1. The next step is to provide the payload URL. The payload URL is the URL of the server that will receive the webhook POST requests. Paste the copied URL generated by AutoRABIT or enter the payload URL manually. Payload URL: < instance_url>/api/webhook/v2/<orgname>/trigger-scm-push-request For example: If the instance is https://login.autorabit.com, then the payload URL would be: https://login.autorabit.com/api/webhook/v2/autorabit.com/trigger-scm-push-request

  2. Add the basic authentication details as shown below. Basic authentication username: ARM login username. Basic authentication password: Webhook type API token generated from ARM.

  1. Enter the Username used in AutoRABIT and password as webhook API Token generated in ARM.

  1. Confirm the settings are correct, test the subscription, and then finish the wizard.

  1. Click on the Finish button to complete the service hook subscription. The webhook can be seen in the Service Hooks tab.

  1. Once the build is triggered via webhook and completed successfully, refresh the service hook tab to verify that the webhook succeeded. You can also view the history of webhooks to see how many times the event was triggered and whether the webhook was completed successfully.

Smart Commits

In this section, you can select the pattern used to read the comment in a revision associated with your ALM story. For example, 'git commit m [project123] # add README file into the project'.

If you want to configure a webhook in your repository, select the Enable auto update on webhook checkbox to reveal the URL required for the webhook settings. For more information on how to configure a webhook in different repositories, refer HERE. You can also choose to sync external smart commits.

For Enterprise customers

/api/webhook/v2/<orgname>/enterprise/trigger-scm-push-request

/api/webhook/v2/<orgname>/enterprise/sync-alm-commits

Last updated