Skip to main content
webhooktrap test replays events from fixture files instead of captures. A fixture is one JSON file per event. By default they live in webhooktrap/fixtures/<provider>/, read in file-name order; fixtures: in webhooktrap.yml lists them explicitly.
webhooktrap/fixtures/stripe/invoice.paid.json
Unknown fields are refused. File paths may contain only A-Z, a-z, 0-9, _, ., / and -, must end in .json, can’t contain .., and must be regular files.

Making fixtures from captures

A fixture’s body must be byte-for-byte what the provider sent. Download a capture’s exact body from its delivery page (Download raw), and copy the headers you need from the same page. Keep the body as received: re-serialising the JSON changes the bytes.
The Fixtures tab in the app is marked Soon: exporting fixtures from the app is not available in 2.0.

Secrets in fixtures

Don’t commit real customer data or secrets. Fixtures carry no signature, so the secret only needs to be in the environment when webhooktrap test runs, and in CI it can be a test-only value your handler is configured with.