Skip to content

webhook.md

Latest commit

 

History

History
55 lines (36 loc) · 1.29 KB

webhook.md

File metadata and controls

55 lines (36 loc) · 1.29 KB
Raw

webhook

Receive external events (Stripe, GitHub, etc.) at a path.
Kind Keyword
Since 0.1.0
Repeatable yes

Syntax

webhook <path> [secret env <VAR>]

Arguments

Name Type Required
path path yes

Description

A webhook is an HTTP POST endpoint that authenticates requests via a shared secret (read from an env var) and dispatches to an on event <name> handler matching the event payload. Use this to process payment confirmations, VCS pushes, and any other inbound integration.

Children

Examples

Handle Stripe payment confirmations

webhook /stripe/payment secret env STRIPE_SECRET
  on event payment_intent.succeeded
    query: UPDATE order SET status = 'paid' WHERE stripe_id = :event_id

See also

Provenance

⚠ Implementation touched after spec. Source code changed on 2026-05-20, but this entity's spec was last edited on 2026-05-08. The description may be out of date.
Spec last touched 5da8498 (2026-05-08)
Source last touched af278bb (2026-05-20)
Source files internal/parser/parser.go