Source type

Bitbucket Source Configuration

Bitbucket sources receive repository, pull request, branch, tag, and build status webhooks with HMAC verification.

BITBUCKETPOST, PUT, PATCH, DELETEWebhook Signing SecretDeveloper tools
Bitbucket Cloud webhooks documentationAll source types
Bitbucket sends webhook traffic to a FastHook source, FastHook validates the provider contract, records the request, and routes accepted events through connections to destinations.BitbucketProviderPOST, PUT, PATCH, DELETESignedFastHookSource URLBITBUCKETProvider credentialsignatureVerify before queue401 on auth failure405 on wrong methodAcceptedRequestverified: trueConnections route the accepted request to destinationsFilters, transformations, retries, replay, and destination signatures stay downstream from source verification.

Bitbucket configuration

Create a Bitbucket source, keep POST and PUT and PATCH and DELETE enabled, and provide the configured Webhook Signing Secret values for provider signature. FastHook uses these settings to validate each Bitbucket delivery before it enters the routing workflow.

Source Type

BITBUCKET

Allowed methods

POST, PUT, PATCH, DELETE

Authentication

Provider signature

Credential fields

Webhook Signing Secret

Bitbucket source config
{
  "type": "BITBUCKET",
  "config": {
    "auth_type": "PROVIDER_SIGNATURE",
    "auth": {
      "provider": "BITBUCKET",
      "webhook_signing_secret": "provider-secret"
    },
    "allowed_http_methods": ["POST","PUT","PATCH","DELETE"]
  }
}

Bitbucket request contract

FastHook computes sha256= HMAC-SHA256 over the raw body and compares it with x-hub-signature.

POSTPUTPATCHDELETE

Bitbucket headers

Preserve x-hub-signature, x-event-key when sending Bitbucket test deliveries. FastHook evaluates this request context before accepting the payload, so missing or modified values remain visible as rejected requests instead of routed events.

x-hub-signature

sha256= HMAC-SHA256 signature over the raw body.

x-event-key

Bitbucket event key, useful for routing.

Bitbucket setup

  1. Create a Bitbucket Cloud webhook using the FastHook Source URL.
  2. Paste the webhook secret into FastHook.
  3. Route by x-event-key or repository fields.

Continue with Bitbucket