Skip to content

formstack: add 1 captured sample - #57

Merged
garethx merged 2 commits into
hookdeck:mainfrom
garethx:samples-formstack
Sep 25, 2026
Merged

garethx merged 2 commits into
hookdeck:mainfrom
garethx:samples-formstack

Conversation

@garethx

@garethx garethx commented Sep 25, 2026 •

Copy link
Copy Markdown
Contributor

Adds Formstack (Forms WebHook submit action) with one captured sample.

  • Provenance. latest is marked sourced_via: capture, sourced_on: 2026-09-25. The file has no source key. It was captured through a Hookdeck source, and the x-hookdeck-* headers were removed the same way requestReceiver.ts does it.
  • No topic identifier. Formstack sends no event type in any header or body field, because a WebHook fires only on a form submission. So topic_identifier is null, following supabase-auth-hooks. The file is named submission, and providers/formstack/README.md says this is a label, not Formstack vocabulary.
  • Real signature. The signature header is left in. The WebHook's HMAC Key was the throwaway test1, and the README gives the wire bytes and the command that reproduces it:
FormID=6606394&UniqueID=1500878955&HandshakeKey=test
x-fs-signature: sha256=30dff7f180b6d69eab397a5d51719474df490b730514c253e8b5832d3b51b970
  • Shared Secret. HandshakeKey is the WebHook's Shared Secret, also a throwaway (test).

Checks: yarn compile and yarn test pass.

Related PRs:

🤖 Generated with Claude Code

A real Formstack Forms WebHook delivery captured on 2026-09-25 through a
Hookdeck source, with the x-hookdeck-* headers removed. Formstack sends no
event type, so topic_identifier is null and the file is named submission.
The README says the name is a label, not a wire value.

The HMAC Key and Shared Secret were throwaway values (test1, test), so the
signature can be recomputed from the documented wire bytes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 25, 2026

Copy link
Copy Markdown

@garethx is attempting to deploy a commit to the Hookdeck Team on Vercel.

A member of the Team first needs to authorize it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 25, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
webhook-samples Ready Ready Preview Sep 25, 2026 1:49pm UTC

Request Review

@garethx
garethx merged commit 6cd23f6 into hookdeck:main Sep 25, 2026
4 checks passed

This branch was successfully deployed

1 active deployment
Preview — 4f7757a9 Deployed Sep 25, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant