Webhook endpoint

messagingwebhook-endpoint

HTTP endpoint that receives callbacks from a third party.

Category: Messaging
Properties: 4
Components: 4
Rules: 1

Properties · 4 defined by this kind

A node of this kind resolves each property from its own props, then the component's defaults, then the default below.

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

Rules for this kind · 1

Webhook without signature verification or idempotencyerror

webhook-without-signature-or-idempotency

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.

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

Components · 4

vendor-neutral

Generic webhook endpointwebhook-endpointgenericthe kind itself

default

Hookdeckhookdeck4 defaults Svixsvix4 defaults Webhook receiverwebhook-receiver3 defaults

Source

1# yaml-language-server: $schema=../schema/kind.schema.json
2# Abstract kind: An HTTP endpoint you expose to receive callbacks from a third party (PSP, SaaS, provider).
3schemaVersion: "1"
4type: "kind"
5id: "webhook-endpoint"
6category: "messaging"
7properties:
8  signatureVerified:
9    type: "boolean"
10    default: false
11  idempotent:
12    type: "boolean"
13    default: false
14  retriedByCaller:
15    type: "boolean"
16    default: true
17  managed:
18    type: "boolean"
19    default: false

The same page as markdown, for an agent: /catalogue/kinds/webhook-endpoint.md