A complete reference for the Hookdeck webhook proxy API — covering event monitoring, request inspection, bulk retries, connection management, sources and destinations, filters, transformations, retry configuration, and failure investigation patterns. Built from real production work at D1DX.
| Topic | What it covers |
|---|---|
| API Base | Base URL, auth header, API version (2025-01-01) |
| Events | List by status/response code/time range/connection, get details, single retry, mute |
| Requests | Original incoming webhook inspection, request vs event distinction |
| Bulk Operations | Bulk retry by status, response code, and time range; async batch status polling |
| Connections | List, create, pause/unpause connections |
| Sources & Destinations | List, update destination URL |
| Filters & Transformations | Connection-level payload filtering, transformation rules |
| Retry Configuration | Custom retry strategies (linear/exponential), attempt counts, intervals |
| Investigation Patterns | Diagnose failed webhooks end-to-end, count failures by HTTP status code |
| Critical Gotchas | No MCP server, request vs event ID confusion, bulk async model, pause vs disable behavior, HTTPS requirement |
git clone https://github.com/D1DX/hookdeck-skill.git
cp -r hookdeck-skill ~/.claude/skills/hookdeckOr as a git submodule:
git submodule add https://github.com/D1DX/hookdeck-skill.git path/to/skills/hookdeckCopy SKILL.md (and supporting files) into your agent's prompt or knowledge directory. The skill is structured markdown — works with any LLM agent that reads reference files.
hookdeck-skill/
├── SKILL.md — Main skill file
└── README.md — This file
Distilled from using Hookdeck as a webhook proxy layer in front of n8n — handling ingestion from Chatwoot, WAHA, and other platforms. Covers patterns for bulk failure recovery, connection management, and payload inspection developed through production incident response.
Built by Daniel Rudaev at D1DX.
MIT License — Copyright (c) 2026 Daniel Rudaev @ D1DX