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

# Create Webhook

> Register a new webhook subscription

Creates a new webhook subscription for the organization. The signing secret is returned only once in the response -- store it securely for signature verification.

**Permission:** `webhooks:manage`

## Request body

<ParamField body="name" type="string" required>
  A human-readable name for the webhook (e.g. "Inventory Notifications")
</ParamField>

<ParamField body="url" type="string" required>
  The HTTPS URL to receive webhook POST requests. Must use `https://` and point to a public hostname (bare IPs, private/loopback addresses, and `http://` are rejected).
</ParamField>

<ParamField body="events" type="string[]" required>
  Event types to subscribe to. Must include at least one. See the [Webhooks guide](/guides/webhooks#event-types) for all available events.
</ParamField>

## Response

Returns the webhook ID and signing secret. The signing secret is only shown once.

```json theme={null}
{
  "data": {
    "id": "wh_abc123",
    "signingSecret": "whsec_d4d6eb900e291d584a235aeebff1aabe5297a9eef4b823a5d6dc5532dc67b0a8"
  }
}
```

<Note>
  Store the `signingSecret` securely. You will need it to [verify webhook signatures](/guides/webhooks#signature-verification). It cannot be retrieved after this response.
</Note>