Webhook Payload Diff

Compare two webhook payloads and see the differences.

Original Payload

Modified Payload

What is a Webhook Payload Diff?

A webhook payload diff is a comparison between two JSON payloads that highlights exactly what changed between them. Webhook providers frequently update their payload structures — adding new fields, renaming keys, or changing data types — and these changes can silently break your integration if you don't catch them early. Diffing payloads gives you a clear, line-by-line view of additions, removals, and modifications.

By comparing payloads side by side, you can quickly identify breaking changes before they reach production. This is especially valuable when a webhook provider announces a new API version, when your handler starts receiving unexpected data, or when you need to verify that your test environment matches production. A structured diff eliminates guesswork and makes debugging faster.

How to Compare Webhook Payloads

1 Paste the original webhook payload into the left panel. This is typically the payload you received before the change or from your current production environment.
2 Paste the modified webhook payload into the right panel. This could be a payload from a newer API version, a test environment, or a different webhook event.
3 Click Compare to see the differences highlighted. Added lines appear in green, removed lines in red, and unchanged lines in gray.

When to Use Payload Diffing

Comparing webhook versions after provider updates — When a provider like Stripe, GitHub, or Shopify releases a new webhook API version, diff the old and new payloads to see exactly what changed.
Debugging unexpected payload changes — When your webhook handler starts failing, compare a working payload with the failing one to pinpoint the difference.
Verifying test vs production payloads — Ensure your staging environment sends the same payload structure as production to avoid surprises during deployment.
Code review for webhook handling changes — Share a diff of expected payloads alongside code changes so reviewers understand the data contract.

FAQ

Does the order of JSON keys matter?

No. The tool parses and re-serializes both payloads with consistent formatting before comparing, so key order does not affect the results. Two objects with the same keys and values in different orders will show no differences.

Can I compare non-JSON payloads?

Currently this tool only supports JSON. For XML, form-encoded, or other payload formats, convert them to JSON first using an appropriate converter, then paste the results here for comparison.

How does the diff algorithm work?

The tool uses the LCS (Longest Common Subsequence) algorithm to find the minimal set of changes between two payloads. It first normalizes and pretty-prints both JSON objects, then compares them line by line to identify additions, removals, and unchanged sections. This produces a clean, readable diff similar to what you would see in a version control system.

Track payload changes over time?

HookWatch stores complete webhook histories so you can compare payloads across deliveries.

Get Started Free