---
updatedAt: 2026-03-27T13:37:50.000Z
agentTools:
  projectIndex: https://developers.workbright.com/llms.txt
---

# Setup

Webhooks enable you to listen to certain events that happen within WorkBright. When an event happens, we will "notify" you by sending an HTTP `POST` request to a pre-configured URL. By leveraging webhooks, you can easily customize the WorkBright experience to suit your needs.

## Configuration

To set up your webhooks, navigate to the Webhooks Settings page at:

`https://YOUR_SUBDOMAIN.workbright.com/settings/webhooks`

Create a Webhook Endpoint by adding a `Name`, `URL`, and selecting the `Events` you would like your endpoint to receive.

<Image align="center" alt="Screenshot of &#x22;Create a new webhook endpoint&#x22;" caption="Screenshot of &#x22;Create a new webhook endpoint&#x22;" src="https://files.readme.io/693e5e2-image.png" />

<br />

## Authentication (optional)

If you want to protect your webhook endpoint, you are able to secure it using standard HTTP Authentication. In this case, supply a valid `Username` and `Password` to WorkBright so that we can issue HTTP POST requests successfully. The `Password` will be provided as a Base64-encoded string. This is not your WorkBright login information, choose something unique that your backend code will use to identify valid requests. This will come in with the request as a Header, see [Payloads](https://developers.workbright.com/docs/webhooks-payloads) for more information.