Comprehensive guide to the Hookdeck Event Gateway for receiving, routing, and delivering webhooks and events. Covers setup, connections, authentication, local development, monitoring, and API automation. Use when receiving webhooks, setting up webhook endpoints, testing webhooks locally, configuring webhook relay or event queue, event routing, webhook retry, webhook monitoring, third-party routing, asynchronous APIs, or local webhook development. For provider webhooks (Stripe, Shopify, Chargebee, GitHub, etc.), use together with the matching skill from hookdeck/webhook-skills; do not only parse JSON — use provider SDK verification and event construction (e.g. Stripe constructEvent).
59
67%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Low
Low-risk findings worth noting
Fix and improve this skill with Tessl
tessl review fix ./skills/event-gateway/SKILL.mdLow
Low-risk findings.
2 low severity findings. Worth noting, but not necessarily harmful.
The skill exposes the agent to untrusted, user-generated content from public third-party sources, creating a risk of indirect prompt injection. This includes browsing arbitrary URLs, reading social media posts or forum comments, and analyzing content from unknown websites.
At runtime, the skill’s webhook handler ingests **OUTSIDER-authored HTTP request body content** (the provider’s webhook payload) and parses it (e.g., `JSON.parse(req.body.toString())` / `json.loads(raw_body)`), which is untrusted free text that could be forwarded into the agent/LLM context if the agent logs or summarizes it.
The skill fetches instructions or code from an external URL at runtime, and the fetched content directly controls the agent’s prompts or executes code. This dynamic dependency allows the external source to modify the agent’s behavior without any changes to the skill itself.
The skill explicitly instructs agents to fetch and run external content at runtime — e.g. installing provider skills via "npx skills add hookdeck/webhook-skills --skill {provider}-webhooks -y -g" (repo: https://github.com/hookdeck/webhook-skills) and fetching docs via curl like "curl https://hookdeck.com/docs/connections.md" — both of which retrieve remote code/content that the agent is told to use as authoritative and, in the case of the npx install, can execute during install, so this is a runtime external dependency controlling prompts/execution.
09dac39
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.