> ## Documentation Index
> Fetch the complete documentation index at: https://village-docs.villagelabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Real-time notifications from Village Intelligence

## Village Intelligence Webhooks

Receive real-time notifications about ESOP intelligence updates.

## What are Webhooks?

Webhooks send automated notifications to your systems when events occur:

* Regulatory updates
* New litigation
* Content changes
* Custom alerts

## Event Types

### Regulatory Events

**Notifications for:**

* New DOL guidance
* IRS rulings
* Legislative changes
* Court decisions

### Content Events

**Updates about:**

* New articles
* Updated guidance
* Added cases
* Revised benchmarks

### Custom Events

**Your specific interests:**

* Keyword alerts
* Topic monitoring
* Client-specific
* Custom triggers

## Webhook Setup

<Steps>
  <Step title="Configure Endpoint">
    Provide URL to receive notifications
  </Step>

  <Step title="Select Events">
    Choose which events to monitor
  </Step>

  <Step title="Set Filters">
    Define what triggers notifications
  </Step>

  <Step title="Test & Activate">
    Verify and go live
  </Step>
</Steps>

## Payload Format

**JSON structure:**

```json theme={null}
{
  "event_type": "regulatory_update",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "title": "New DOL Guidance on ESOP Valuations",
    "summary": "...",
    "url": "...",
    "priority": "high"
  }
}
```

## Security

**Verified delivery:**

* HMAC signatures
* HTTPS only
* Retry logic
* Delivery confirmation

## Get Started

<Card title="Configure Webhooks" icon="webhook" href="mailto:support@villagelabs.com?subject=Village Intelligence Webhooks">
  Contact us to set up webhooks
</Card>

<Note>
  **Webhooks available with Enterprise plan in 2025**
</Note>
