Test Bitbucket Webhooks with HookTest

Quick Start

Get Bitbucket webhooks flowing to HookTest in under a minute:

1. Create a HookTest URL. Go to hooktest.dev and click Create Bin. Copy the webhook URL.
2. Add it to Bitbucket webhook settings. Paste the HookTest URL as your webhook endpoint in the Bitbucket developer dashboard. Select the events you want to receive.
3. Trigger an event and inspect. Perform an action in Bitbucket (or use their test/sandbox mode) and watch the request appear in HookTest in real time. Check headers, body, and query parameters.

Common Bitbucket Webhook Events

These are the most commonly tested Bitbucket webhook events. Each one triggers an HTTP POST to your webhook URL with a JSON payload.

Verifying Bitbucket Signatures

Bitbucket signs every webhook request using the X-Hub-Signature header. You should always verify this signature in production to confirm the request actually came from Bitbucket and was not tampered with in transit.

When testing with HookTest, you can inspect the raw signature header value in the request details. This is useful for verifying that your signature verification code handles the header format correctly before deploying to production.

See the official Bitbucket webhook docs for the full signature verification algorithm and code samples.

Why Test Bitbucket Webhooks?

Webhook handlers are notoriously hard to debug. You cannot see what Bitbucket is sending until your endpoint receives it, and errors in your handler can cause silent failures — missed payments, lost data, or broken integrations.

HookTest gives you full visibility into every request before you write a line of handler code. Create a bin, point Bitbucket at it, and see exactly what arrives: HTTP method, headers (including signatures), body, and query parameters. Once your handler is ready, use webhook forwarding to send requests to your local server in real time.

Related Guides