---
id: "webhook-endpoint"
type: "component"
kind: "webhook-endpoint"
provider: "default"
category: "messaging"
url: "https://localhost:3000/catalogue/components/webhook-endpoint"
---

# Generic webhook endpoint

Vendor-neutral webhook endpoint. Use when the real product is not in the catalogue; every rule for this kind still applies.

| | |
|---|---|
| Provider | [default](https://localhost:3000/catalogue?provider=default) |
| Kind | [Webhook endpoint](https://localhost:3000/catalogue/kinds/webhook-endpoint) |
| Category | Messaging |
| Official docs | not recorded |
| Generic? | Vendor-neutral: the kind itself |

## Properties

| property | type | values | required | default |
|---|---|---|---|---|
| `idempotent` | boolean | — | no | false |
| `managed` | boolean | — | no | false |
| `retriedByCaller` | boolean | — | no | true |
| `signatureVerified` | boolean | — | no | false |

## Rules that apply · 1

### Webhook without signature verification or idempotency `webhook-without-signature-or-idempotency` (error)

- Page: https://localhost:3000/catalogue/rules/webhook-without-signature-or-idempotency.md
- Why: A webhook is a public endpoint that its caller retries. Without signature verification anyone can post a fake event; without idempotency the provider's own retries apply the same event twice.
- Applies to: every node of kind webhook-endpoint
- Message: Webhook '{{node.id}}' does not verify signatures or is not idempotent. Verify the caller's signature and deduplicate by event id.

It fires when:

- any of these hold:
  - the node's `signatureVerified` is false
  - the node's `idempotent` is false

## Other products of the same kind · 3

- [Hookdeck](https://localhost:3000/catalogue/components/hookdeck.md) `hookdeck` — default
- [Svix](https://localhost:3000/catalogue/components/svix.md) `svix` — default
- [Webhook receiver](https://localhost:3000/catalogue/components/webhook-receiver.md) `webhook-receiver` — default

## Use it in a design

```yaml
nodes:
  - { id: "webhook-endpoint", component: "webhook-endpoint" }
```

## Source (`component` YAML, verbatim)

```yaml
# yaml-language-server: $schema=../../schema/component.schema.json
# The vendor-neutral webhook endpoint: the kind itself, with no product behind it. It sets no
# defaults and adds no properties, so every required kind property stays required on the node.
schemaVersion: "1"
type: "component"
id: "webhook-endpoint"
kind: "webhook-endpoint"
provider: "default"
```

Human page: https://localhost:3000/catalogue/components/webhook-endpoint