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

# Webhooks API

> Endpoints for registering, listing, and testing webhook subscriptions.

### Register Webhook Endpoint

```http theme={null}
POST /v2/webhooks
```

```json theme={null}
{
  "url": "https://api.company.com/security/snapsec-events",
  "events": ["finding.created", "sla.breached"],
  "secret": "whsec_custom_secret_key_123"
}
```

### Test Webhook Dispatch

```http theme={null}
POST /v2/webhooks/{webhook_id}/ping
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.