# Poke Webhooks

> Design and wire up Poke webhook triggers — translate an event source (deploy fail, new signup, alert) into a `createWebhook` + `sendWebhook` pair with a sensible condition/action and a safe payload shape. Use when the user asks to "trigger Poke when X happens", "notify Poke from my app", "build a Poke webhook", or wires Poke into CI/cron/serverless events.

- Skill: `hktitan/poke-webhooks` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add hktitan/poke-webhooks`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hktitan/poke-webhooks/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- License: MIT
- Author: HKTITAN (https://skillmd.com/u/hktitan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hktitan/poke-webhooks

---


# Poke Webhooks — Map of Content

Poke webhooks are persistent triggers: register once, fire many. This skill is structured as a graph — scan the descriptions, follow only the `[[wikilinks]]` you need.

For SDK basics see the [[../poke/SKILL]] graph.

## Core mental model

- [[references/condition-action-model]] — what `condition` and `action` actually do; how to write good ones.
- [[references/trigger-once-fire-many]] — why you call `createWebhook` once and persist the result.
- [[references/payload-shape]] — what `data` should look like; identifiers, truncation, no secrets.

## Reliability

- [[references/retry-policy]] — backoff rules per error class; idempotency notes.

## Wiring patterns (one node per source)

- [[references/vercel-pattern]] — Next.js / Vercel route handler.
- [[references/github-actions-pattern]] — fire from CI on `failure()`.
- [[references/cron-pattern]] — scheduled / digest triggers.
- [[references/bootstrapping]] — checklist for adding Poke webhooks to an existing app.

## Sibling nodes (in the `poke` graph)

- [[../poke/references/create-webhook]] — the SDK method.
- [[../poke/references/send-webhook]] — the firing method.
- [[../poke/references/auth-errors]] — what `PokeAuthError` means for webhooks.