> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tidyhire.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Introduction
> Receive real-time notifications when events happen in your workspace
## Overview
Webhooks allow you to receive real-time HTTP notifications when specific events occur in your Tidyhire workspace. When an event is triggered, Tidyhire sends a `POST` request to your configured URL with the event payload.
## Setting Up Webhooks
1. Navigate to **For Developers** > **Webhooks** in your [Tidyhire Dashboard](https://platform.tidyhire.app/app/developers#webhooks).
2. Click **+ Add Webhook**.
3. Enter your **Webhook URL** — the endpoint that will receive event payloads.
4. Select the **events** you want to subscribe to.
5. Click **Create**.
## Testing Webhooks
You can send a test event to any active webhook from the Tidyhire Dashboard. This sends a sample payload to your URL so you can verify your integration is working correctly before going live.
## Best Practices
* **Use HTTPS** — Always use an HTTPS endpoint to ensure payload data is encrypted in transit.
* **Respond quickly** — Return a 2xx response as soon as possible. Process the payload asynchronously if needed.
* **Verify the payload** — Validate incoming data before processing to guard against unexpected payloads.
* **Handle duplicates** — Design your handler to be idempotent in case the same event is delivered more than once.
## In This Section
The events Tidyhire can send to your webhook.
The payload format for webhooks.
What happens when delivery fails and how to acknowledge events.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.