Manage repository webhooks using web UI

You must have admin privileges to the repository to create a webhook or edit any aspect of an existing webhook.

Create a webhook for your repository

1. In your browser, navigate to https://<msr-url> and log in with your credentials.

2. Select Repositories from the left-side navigation panel, and then click the name of the repository that you want to view. Note that you will have to click the repository name following the / after the specific namespace for your repository.

3. Select the Webhooks tab, and click New Webhook.

4. From the drop-down list, select the event that will trigger the webhook.

5. Set the URL that will receive the JSON payload.

6. Validate the integration by clicking the Test button next to the Webhook URL field. If the integration is working, you will receive a JSON payload at the URL you specified for the event type notification you selected.

   Example output:

   {
     "type": "TAG_PUSH",
     "createdAt": "2019-05-15T19:39:40.607337713Z",
     "contents": {
       "namespace": "foo",
       "repository": "bar",
       "tag": "latest",
       "digest": "sha256:b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c",
       "imageName": "foo/bar:latest",
       "os": "linux",
       "architecture": "amd64",
       "author": "",
       "pushedAt": "2015-01-02T15:04:05Z"
     },
     "location": "/repositories/foo/bar/tags/latest"
   }
   

7. Expand guilabel:Show advanced settings.

8. Paste the TLS certificate associated with your webhook URL into the TLS Cert field.

   Note

   For testing purposes, you can test your TLS certificate over HTTP rather than HTTPS.

9. Click Create to save the webhook. Once saved, your webhook is active and starts sending POST notifications whenever your selected event type is triggered.

As a repository admin, you can add or delete a webhook at any point. Additionally, you can create, view, and delete webhooks for your organization or trusted registry using the API.