# POST /webhooks/subscriptions

**Resource:** [Webhooks](./webhooks.md)  
**Scopes:** `webhooks:write`  
**Write operation:** yes

Subscribe to webhook events. url, events array, and secret are required.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `url` | body | string | yes | Delivery URL |
| `events` | body | string[] | yes | Event types to subscribe to |
| `secret` | body | string | yes | Signing secret for payload verification |

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`