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

# Webhook Reference

> Webhook payloads sent by ProxyLink for monitoring events and network automation triggers.

## Monitoring alerts

ProxyLink sends a POST request to your webhook URL when a monitored service changes state.

### Service down

```json theme={null}
{
  "status": "down",
  "label": "Hotel Anna — NVR",
  "target": "192.168.20.10:80",
  "time": "2026-05-11 20:00:00 EEST"
}
```

### Service recovered

```json theme={null}
{
  "status": "up",
  "label": "Hotel Anna — NVR",
  "target": "192.168.20.10:80",
  "time": "2026-05-11 20:07:00 EEST"
}
```

## Network automation trigger

Trigger a network automation from an external system (NinjaRMM, Zabbix, Grafana) by calling the automation's unique webhook URL. The secret in the URL is the authentication — no headers or tokens needed. Copy the full URL from the automation's detail page:

```bash theme={null}
curl -X POST https://app.proxylink.dev/automations/trigger/{secret}
```

The automation runs immediately and returns the output.

## Request headers

All incoming webhooks from ProxyLink include:

```
Content-Type: application/json
X-ProxyLink-Event: down|up
```
