Examples / Source control and developer tools / Bitbucket Cloud

Bitbucket Cloud webhooks

Pushes, pull requests, build statuses and repository changes.

Events

repo:push
pullrequest:created
pullrequest:fulfilled
repo:commit_status_updated

Signature

Header X-Hub-Signature: 'sha256=' + HMAC-SHA256 of the raw body with the secret, hex encoded, when a secret is set.

✓ A bin checks Bitbucket Cloud signatures: add the webhook secret under Signature verification (GitHub).

Check a Bitbucket Cloud signature with the free tool (use the GitHub preset).

Retries

Bitbucket does not retry failed deliveries.

See a retry schedule in the calculator.

Docs

support.atlassian.com/bitbucket-cloud/docs/manage-webhooks/

Checked 2026-10-08. Report a change.

Sample request from Bitbucket Cloudillustrative, shortened

Content-Typeapplication/jsonX-Event-Keyrepo:pushX-Hook-UUIDa1b2c3d4-…X-Hub-Signaturesha256=7d38cdd6…

{
  "push": {
    "changes": [ { "new": { "type": "branch", "name": "main", "target": { "hash": "b2c3d4e5f607", "message": "Retry webhook deliveries with backoff" } } } ]
  },
  "repository": { "full_name": "acme/shop-api" },
  "actor": { "nickname": "ravi" }
}

Receive Bitbucket Cloud webhooks with webhooks.xyz

Create a bin. Paste its URL into Bitbucket Cloud. Each request shows at once with its headers and body. Add your secret, and each request gets a verified or failed mark. Add your server as a destination, and deliveries retry when it is down. Request an invite.

More in source control and developer tools: GitHub, GitLab, Jira Cloud, Linear.