# Webhook Notification Settings

*Applies to: Patch My PC Publisher*

## **Overview**

**Webhook notifications** allow the Publisher to send publishing alerts and reports to external messaging systems such as Microsoft Teams workflows and Slack. Webhooks provide near real time visibility into publishing activity without relying on email notifications.

Webhook notifications are commonly used to notify operations, security, or platform teams when publishing events occur.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FOgTsWMd3XrqZ89URwzwW%2Fimage.png?alt=media&#x26;token=b3c62b74-1f08-40d8-a347-3605d1fc1ba8" alt="Webhook Notifications" width="563"><figcaption></figcaption></figure>

When webhook notifications are enabled, the Publisher sends HTTP POST messages to the configured webhook endpoints based on publishing events and the selected notification level. Each configured webhook represents a single destination, such as a Teams channel or Slack workspace.

Multiple webhook destinations can be configured, and each webhook can be independently enabled, disabled, tested, or removed.

## Send Webhook Reports

Webhook notifications must be enabled before individual webhooks can be configured.

1. Open the Publisher console and navigate to **Alerts**.
2. Expand **Webhook Notifications**.
3. Select **Send Webhook Reports** to enable webhook notifications.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FzWUImSCrjVeRVpm1QSVF%2Fimage.png?alt=media&#x26;token=c36081f7-7495-452e-a627-60fb3e1d70fd" alt="Send Webhook Reports" width="545"><figcaption></figcaption></figure>

## Add a Webhook

Use this option to create a new webhook notification.

1. To add a new webhook notification, click **Add**.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FapwH058neiLqoXOaMKCE%2Fimage.png?alt=media&#x26;token=e9794dba-c670-4d55-886a-abc6f9c2d853" alt="Add a Webhook Notification" width="545"><figcaption></figcaption></figure>

2. Continue to [Edit a Webhook](#edit-a-webhook).

## Edit a Webhook

Use this option to configure a new webhook after clicking Add, or to modify an existing webhook by updating settings such as the webhook URL, notification level, or label.

The **Edit** option opens the webhook configuration dialog. This dialog is used in two scenarios.

* After clicking [Add](#add-a-webhook) when creating a new webhook.
* When selecting an existing webhook and clicking **Edit**.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2F1UjgXl0fxUGVSKeI0MiJ%2Fimage.png?alt=media&#x26;token=8b10def5-f356-4e17-bb5a-0b8f464f399c" alt="Edit a Webhook" width="545"><figcaption></figcaption></figure>

In both cases, the same configuration screen is used to define or modify the [webhook configuration](https://docs.patchmypc.com/patch-my-pc-publisher/administration/alerts/webhook-notifications/webhook-configuration).

## Copy a Webhook

Use this option to create a new webhook configuration based on an existing webhook.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FPFcMmWOnnYaStjrctMBH%2Fimage.png?alt=media&#x26;token=3d24b0ef-04e3-4dee-9855-9ea68d837a66" alt="Copy a Webhook" width="545"><figcaption></figcaption></figure>

When you select a webhook and click Copy, the [webhook configuration](https://docs.patchmypc.com/patch-my-pc-publisher/administration/alerts/webhook-notifications/webhook-configuration) dialog opens with settings pre populated from the selected webhook. You must provide a new **Name** and **Webhook URL** before the webhook can be saved.

All other settings are copied from the original webhook, including the message system and notification level. Webhook scope and product selection are also copied, allowing the new webhook to inherit the same filtering and targeting configuration.

## Remove a Webhook

Use this option to delete a webhook.

When you select a webhook and click **Remove**, the webhook is removed from the list and will no longer receive notifications.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FJCnDemPlIr5y0JYmDn1o%2Fimage.png?alt=media&#x26;token=0e87458f-ed83-4b78-80ae-bd705920073e" alt="Remove a Webhook" width="545"><figcaption></figcaption></figure>

{% hint style="warning" %}
**Important**

Removing a webhook does not display a confirmation dialog. The webhook is permanently deleted after the Publisher settings are saved. If you close and re-open the Publisher without savings the Publisher settings, the deleted webhook is restored.
{% endhint %}

## Test a Webhook

Use this option to validate an individual webhook configuration by sending a test notification to the selected destination.

Each webhook is tested independently. Only the selected webhook is used when the test is run.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FB1P3Gbym5Is5yhzcr1UL%2Fimage.png?alt=media&#x26;token=9186cffe-2a86-4f1b-b022-c71e9a2b5f1b" alt="Test a Webhook" width="545"><figcaption></figcaption></figure>

The Publisher sends a test HTTP POST message to the webhook URL configured for the selected webhook.

If the test is successful, a confirmation message is displayed indicating that the test webhook notification was sent successfully. The message should also appear in the target system, such as a Microsoft Teams channel or Slack workspace.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FB6KBqXTf7urjE0BHD7mO%2Fimage.png?alt=media&#x26;token=608480f3-edbb-4cc5-a3a0-52a362cc8760" alt="Successful Webhook Test" width="320"><figcaption></figcaption></figure>

If the test fails, an error message is displayed. The error typically indicates connectivity issues, an invalid webhook URL, or a response error from the destination service. The webhook must be corrected before notifications will work.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2Fu27A8K4tqpxP9uN9fcI5%2Fimage.png?alt=media&#x26;token=c217e0e2-eb89-4529-9709-a0afbca46838" alt="Failed Webhook Test" width="427"><figcaption></figcaption></figure>
