Hookdeck Outpost
Outbound event delivery: publish platform events to tenants’ destinations (webhooks, queues, cloud buses—see supported destinations). Open source on GitHub; managed on Hookdeck Cloud or self-hosted.
Single source of truth: Use Hookdeck Outpost documentation for concepts, API, quickstarts, and UI guidance. This skill links there and adds agent workflow notes under references/.
Documentation index for agents
llms.txt: https://hookdeck.com/docs/outpost/llms.txt — plain-text map of doc pages as.mdURLs; fetch once when you need the full tree or many pages.- Concepts: Tenants, destinations, topics, publish
- API reference: REST / OpenAPI; self-hosted spec file:
https://github.com/hookdeck/outpost/blob/main/docs/apis/openapi.yaml - SDKs: Overview — for TypeScript, Python, or Go, follow that language’s quickstart for correct signatures.
- Building your own UI: Guide — screen flow, BFF pattern, implementation checklists.
- Destinations / topics: Destination types · Topics and subscriptions
Quickstarts (smallest path first)
Use the official managed-Outpost walkthroughs before opening full-stack examples in this repo:
| curl (HTTP only) | Hookdeck Outpost curl quickstart |
| TypeScript | TypeScript quickstart |
| Python | Python quickstart |
| Go | Go quickstart |
Compact link list: references/outpost-quickstarts.md.
Test webhook destination URLs (README and docs)
When you need a throwaway HTTPS URL for a webhook destination (quickstarts, curl examples, “verify delivery”):
- Prefer Hookdeck Console — create a Source, copy its URL (e.g.
https://hkdk.events/…), and inspect or replay deliveries in one place. This is the Hookdeck-native default for agents and humans.
Fast path for agents
- Start with references/outpost-scope.md to pick Quick path vs New minimal app vs Existing app.
- If scope is ambiguous, default to the smallest quickstart-shaped artifact.
- Fetch only the language quickstart you need (curl, TypeScript, Python, Go).
- Use references/outpost-verify.md before finishing.
- Open full-stack examples only when the task clearly requires BFF/UI integration patterns.
Scope and verification (agent workflow)
Dashboard-style guidance (no {{PLACEHOLDERS}} — those stay dashboard-only):
- references/outpost-scope.md — three-path ladder, default-to-smallest, language vs architecture, topic reconciliation, SDK vs OpenAPI / BFF pointers with links to Building your own UI anchors.
- references/outpost-verify.md — trimmed “before you stop” checklist.
BFF / wire JSON: Authentication · Wire JSON, SDK responses, and your UI
Supported destination types
Available: Webhooks (HTTP), Hookdeck Event Gateway, AWS SQS, AWS Kinesis, AWS S3, Azure Service Bus, GCP Pub/Sub, RabbitMQ (AMQP), Kafka
Planned: AWS EventBridge
Deployment and API pointers
- Managed: Hookdeck Outpost docs and per-language quickstarts.
- Self-hosted quickstarts: Docker, Kubernetes, Railway, Configuration.
- API reference: Outpost REST / OpenAPI.
- Base URL note: Managed API base is project-specific (quickstarts currently show
https://api.outpost.hookdeck.com/2025-07-01); verify live docs/project settings if unsure.
Full-stack reference examples (advanced)
Use only when the task needs realistic BFF + dashboard patterns—not for “smallest example” (use Quickstarts and llms.txt first).
Integration maps (read before opening trees):
- Next.js: references/nextjs-saas-integration-map.md
- FastAPI: references/fastapi-saas-integration-map.md
Treat examples as references, not copy-paste scaffolds. Prefer the user’s codebase and use maps for Outpost-specific behavior (server-only admin key, tenant mapping, BFF routes, domain publish).
| Example | Stack | Location |
|---|---|---|
| SaaS (Next.js) | App Router + @hookdeck/outpost-sdk + dashboard UI | examples/nextjs-saas/ — README |
| SaaS (FastAPI + React) | FastAPI BFF (httpx → Outpost) + template UI | examples/fastapi-saas/ — README |
Dependency and version pins live in the example manifests (package.json, pyproject.toml).
How to use the examples: Read the integration maps and README overviews first; open other files only when they match the user’s task.
Tests: npm test in nextjs-saas (Vitest); pytest test_outpost_wire.py in fastapi-saas/backend via ./scripts/test-examples.sh outpost. Next.js example uses npm.
Future skills
Destination-specific skills (outpost-webhooks, outpost-sqs, …) may be added as documentation matures.
Related skills
- hookdeck — skill router for Hookdeck products
- event-gateway — Hookdeck Event Gateway (inbound webhooks)