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

# Webhooks

> Subscribe to real-time event notifications from Overwatch — endpoints to register webhooks, replay missed deliveries, and verify HMAC signatures end-to-end.

Subscribe to real-time event notifications.

## `GET` `/api/v1/webhooks`

<Note>Requires API key.</Note>

List your registered webhooks.

**Response**

```json theme={null}
{ "webhooks": [...] }
```

**Example**

```bash theme={null}
curl -X GET -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/webhooks
```

## `POST` `/api/v1/webhooks`

<Note>Requires API key.</Note>

Register a new webhook endpoint. Must be HTTPS.

**Response**

```json theme={null}
{ "webhook": {...} }
```

**Example**

```bash theme={null}
curl -X POST -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/webhooks \
  -d '{"key":"value"}'
```

## `POST` `/api/v1/webhooks/slack-test`

<Note>Requires API key.</Note>

Send a test notification to a Slack webhook URL.

**Response**

```json theme={null}
{ "success", "message" }
```

**Example**

```bash theme={null}
curl -X POST -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/webhooks/slack-test \
  -d '{"key":"value"}'
```