---
title: "Enable Webhooks"
description: "Add a webhook to a Container Registry project so an HTTP endpoint or a Slack channel is notified whenever an artifact event occurs in it."
date: 2026-08-13
lastmod: 2026-08-13
canonical: "https://container-registry.com/docs/2.16/user-manual/projects/configuration/enable-webhooks/"
source: "https://container-registry.com/docs/2.16/user-manual/projects/configuration/enable-webhooks/index.md"
harbor_version: "2.16"
agent_instructions: "This is the markdown representation of https://container-registry.com/docs/2.16/user-manual/projects/configuration/enable-webhooks/index.md. Prefer this version over scraping the HTML. The site index is at https://container-registry.com/llms.txt."
---

> Agent-friendly representation of <https://container-registry.com/docs/2.16/user-manual/projects/configuration/enable-webhooks/index.md>. Site index: <https://container-registry.com/llms.txt>.


# Enable Webhooks

*Add a webhook to a Container Registry project so an HTTP endpoint or a Slack channel is notified whenever an artifact event occurs in it.*


Enable Webhooks
=================================

## Prerequisites

1. Webhooks must be enabled on the instance level by your system administrator (super admin). The instructions are available [here](/docs/2.16/administration-manual/other-system-settings/other-system-settings/index.md).

2. You must be a project administrator to add webhooks to the project. 

## Get Your Webhook URL

You need an endpoint URL that is able to receive HTTP/HTTPS POST requests. 

### HTTP or HTTPS

Configure a webhook listener on a server that will receive messages and perform further actions if their content requires so.

### Slack
You can configure Slack, a popular team messenger, to receive notifications from your project. For this, you need:
* a Slack account;
* a Slack workspace;
* a target channel inside this workspace;
* an app with enabled incoming webhooks.

For the last step, there are two methods to implement it:
1. Add the existing *legacy* **Incoming Webhooks app** from the Slack marketplace:
* Go to [https://slack.com/apps/A0F7XDUAZ-incoming-webhooks?tab=more_info](https://slack.com/apps/A0F7XDUAZ-incoming-webhooks?tab=more_info);
* Click **Install**;
* On the following page, select your channel and click **Add Incoming WebHooks Integration**.
* Alternatively, create a new Slack channel:

![](../webhooks_slack_legacy.png)
    

![](../new_slack_channel.png)

* You'll be redirected to the Setup Instructions page where you can copy your webhook URL:

![](../webhook_url_slack_legacy.png)

After you [add your webhook in the Container Registry GUI](#creating-a-new-webhook-in-the-container-registry-gui), you will start receiving Slack notifications that look like this:

![](../incoming_slack_legacy_message.png)

2. Create your own Slack app and enable webhooks for it.

* Go to [https://api.slack.com](https://api.slack.com) and click **Create an app** or
* Go directly to [https://api.slack.com/apps?new_app=1](https://api.slack.com/apps?new_app=1);
* Select **From an app manifest** if you only need it for the webhooks;

![](../create_slack_app.png)

* Select your workspace;

![](../select_slack_workspace.png)

* Inside the YAML or JSON file, change the name of your app;

![](../rename_slack_app.png)

* Hit **Next** and then **Create**;
* You'll land in the basic information view of your new Slack app; 
* Click **Incoming Webhooks**;

![](../basic_info_slack_app.png)

* Activate incoming webhooks for this app with the slider and then click **Add New WebHook to Workspace**;

![](../activate_incoming_webhook.png)

* Select the target channel to post notifications and click **Allow**;

![](../select_slack_channel2.png)

* Your Slack webhook URL was now generated and can be copied:

![](../webhook_slack_url.png)

Your new app will be visible among your Slack apps:

![](../slack_apps.png)

After you [add your webhook in the Container Registry GUI](#creating-a-new-webhook-in-the-container-registry-gui), you will start receiving Slack notifications that look like this:

![](../webhook_slack_message.png)

## Webhook Triggers

A webhook fires on artifact, Helm chart, scan, quota and replication events. For every event, its event type and the contents of the notification, see [Webhook Event Types](/docs/2.16/user-manual/projects/configuration/webhooks/index.md).

## Creating a New Webhook in the Container Registry GUI

* Go to the **Webhooks** tab in your project;
* Click **+ NEW WEBHOOK**:

![](../create_webhook.png)

* Select *slack* if you copied your endpoint/webhook URL from a Slack application, or select *http* if you use another application to receive push notifications;

* Paste the endpoint URL;

    * For HTTP endpoint URLs, you can provide the **Authorization Header** that specifies your authorization type and contains your credentials, if required, for instance:

``` shell
Authorization: Bearer {{token}}
```

* Select an option to **verify remote certificates**;

    * For HTTP endpoint, *disable* the feature;
    * For HTTPS, *enable* it.

## Webhooks Overview and Details

If you click on the arrow next to a webhook, you can open a detailed overview of the triggers and when they ran for the last time. You may need to flick through the triggers using the arrows in the bottom right corner.

![](../webhooks_overview.png)

## Enabling/Disabling, Editing, and Deleting Webhooks

You can delete webhooks manually or in bulks if you tick the checkboxes and click **Delete** under the **Action** menu.

You can disable/re-enable and edit webhooks one by one if you tick the checkboxes and click **Disable/Enable** or **Edit** under the **Action** menu.

![](../edit_webhooks.png)