{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with Bitbucket.",
  "vendor": "bitbucket",
  "name": "Bitbucket",
  "official_docs": "https://support.atlassian.com/bitbucket-cloud/docs/event-payloads/",
  "docs_checked": "2026-10-18",
  "url": "https://hookdeck.com/webhooks/bitbucket",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/bitbucket"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/bitbucket/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/bitbucket/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/bitbucket/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/bitbucket/guide-duplicates-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/bitbucket/skill"
    }
  ],
  "summary": "Bitbucket signs some webhooks with X-Hub-Signature (HMAC-SHA256).",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature header",
      "value": "X-Hub-Signature",
      "detail": "Not every delivery is signed: check your setup.",
      "source": {
        "kind": "vendor-docs",
        "label": "Bitbucket docs",
        "href": "https://support.atlassian.com/bitbucket-cloud/docs/manage-webhooks/"
      },
      "doc_discrepancy": null
    },
    {
      "key": "scheme",
      "label": "Scheme",
      "value": "HMAC-SHA256",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Bitbucket docs",
        "href": "https://support.atlassian.com/bitbucket-cloud/docs/manage-webhooks/"
      },
      "doc_discrepancy": null
    },
    {
      "key": "signed_material",
      "label": "Signed material",
      "value": "{raw body}",
      "detail": "The request body exactly as sent, with no timestamp or other data added.",
      "source": {
        "kind": "vendor-docs",
        "label": "Bitbucket docs",
        "href": "https://support.atlassian.com/bitbucket-cloud/docs/manage-webhooks/"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "x-event-key header",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Bitbucket docs",
        "href": "https://support.atlassian.com/bitbucket-cloud/docs/event-payloads/"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": "Content type: application/json.",
      "source": {
        "kind": "registry",
        "label": "Registry record",
        "href": "https://hookdeck.com/webhooks/bitbucket.json"
      },
      "doc_discrepancy": null
    },
    {
      "key": "other_headers",
      "label": "Other headers",
      "value": "x-attempt-number, x-b3-sampled, x-b3-spanid, x-b3-traceid, x-event-key, x-event-time, x-hook-uuid, x-request-uuid",
      "detail": null,
      "source": {
        "kind": "registry",
        "label": "Registry record",
        "href": "https://hookdeck.com/webhooks/bitbucket.json"
      },
      "doc_discrepancy": null
    },
    {
      "key": "envelope",
      "label": "Envelope",
      "value": "actor, repository",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Bitbucket docs",
        "href": "https://support.atlassian.com/bitbucket-cloud/docs/event-payloads/"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill bitbucket-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/bitbucket/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "reason": "Bitbucket Cloud only. This is every event GET /2.0/hook_events/workspace returned on 2026-11-04. The Event payloads page documents 25 of the 29. pullrequest:push, repo:created, repo:imported and project:updated appear only in the API. GET /2.0/hook_events/repository returns 24: it adds nothing, and omits the 5 marked workspace_webhooks_only. Bitbucket Data Center's keys are in dropped_wrong_surface.",
    "source_url": "https://support.atlassian.com/bitbucket-cloud/docs/event-payloads/",
    "checked": "2026-07-28"
  },
  "counts": {
    "events": 29,
    "with_payload": 24,
    "captured": 10,
    "with_description": 29,
    "resources": 4,
    "confidence": {
      "verified": 10,
      "documented": 19,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any Bitbucket event"
  },
  "events": [
    {
      "name": "repo:push",
      "resource": "repo",
      "description": "A push creates, updates or deletes a branch or tag",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#repo%3Apush",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/repo-push.json"
    },
    {
      "name": "repo:fork",
      "resource": "repo",
      "description": "Someone forks the repository",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#repo%3Afork",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/repo-fork.json"
    },
    {
      "name": "repo:updated",
      "resource": "repo",
      "description": "Repository name, description, website or language changes",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#repo%3Aupdated",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/repo-updated.json"
    },
    {
      "name": "repo:transfer",
      "resource": "repo",
      "description": "Recipient accepts a repository transfer; workspace webhooks only",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#repo%3Atransfer",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/repo-transfer.json"
    },
    {
      "name": "repo:commit_comment_created",
      "resource": "repo",
      "description": "Someone comments on a commit",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#repo%3Acommit_comment_created",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/repo-commit-comment-created.json"
    },
    {
      "name": "repo:commit_status_created",
      "resource": "repo",
      "description": "A build tool reports a new commit status",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#repo%3Acommit_status_created",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/repo-commit-status-created.json"
    },
    {
      "name": "repo:commit_status_updated",
      "resource": "repo",
      "description": "A build tool changes an existing commit status",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#repo%3Acommit_status_updated",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/repo-commit-status-updated.json"
    },
    {
      "name": "repo:deleted",
      "resource": "repo",
      "description": "Hard deletion finishes, up to 30 days later; workspace webhooks only",
      "confidence": "documented",
      "schema_source": "from Bitbucket docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#repo%3Adeleted",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/repo-deleted.json"
    },
    {
      "name": "repo:created",
      "resource": "repo",
      "description": "New repository appears; workspace webhooks only",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#repo%3Acreated",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/repo-created.json"
    },
    {
      "name": "repo:imported",
      "resource": "repo",
      "description": "A repository gets imported; workspace webhooks only",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#repo%3Aimported",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/repo-imported.json"
    },
    {
      "name": "project:updated",
      "resource": "project",
      "description": "A project field changes; workspace webhooks only",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#project%3Aupdated",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/project-updated.json"
    },
    {
      "name": "pullrequest:created",
      "resource": "pullrequest",
      "description": "Someone opens a pull request",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Acreated",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-created.json"
    },
    {
      "name": "pullrequest:updated",
      "resource": "pullrequest",
      "description": "Someone edits or updates a pull request",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Aupdated",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-updated.json"
    },
    {
      "name": "pullrequest:push",
      "resource": "pullrequest",
      "description": "Pull request receives a push; payload not documented",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Apush",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-push.json"
    },
    {
      "name": "pullrequest:changes_request_created",
      "resource": "pullrequest",
      "description": "Reviewer asks for changes on a pull request",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Achanges_request_created",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-changes-request-created.json"
    },
    {
      "name": "pullrequest:changes_request_removed",
      "resource": "pullrequest",
      "description": "Reviewer withdraws a request for changes",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Achanges_request_removed",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-changes-request-removed.json"
    },
    {
      "name": "pullrequest:approved",
      "resource": "pullrequest",
      "description": "Reviewer approves a pull request",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Aapproved",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-approved.json"
    },
    {
      "name": "pullrequest:unapproved",
      "resource": "pullrequest",
      "description": "Reviewer withdraws a pull request approval",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Aunapproved",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-unapproved.json"
    },
    {
      "name": "pullrequest:fulfilled",
      "resource": "pullrequest",
      "description": "Pull request gets merged",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Afulfilled",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-fulfilled.json"
    },
    {
      "name": "pullrequest:rejected",
      "resource": "pullrequest",
      "description": "Pull request gets declined",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Arejected",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-rejected.json"
    },
    {
      "name": "pullrequest:comment_created",
      "resource": "pullrequest",
      "description": "New comment on a pull request",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Acomment_created",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-created.json"
    },
    {
      "name": "pullrequest:comment_updated",
      "resource": "pullrequest",
      "description": "Pull request comment edited; quick repeat edits are skipped",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Acomment_updated",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-updated.json"
    },
    {
      "name": "pullrequest:comment_deleted",
      "resource": "pullrequest",
      "description": "Pull request comment gets removed",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Acomment_deleted",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-deleted.json"
    },
    {
      "name": "pullrequest:comment_resolved",
      "resource": "pullrequest",
      "description": "Pull request comment gets marked resolved",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Acomment_resolved",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-resolved.json"
    },
    {
      "name": "pullrequest:comment_reopened",
      "resource": "pullrequest",
      "description": "Resolved pull request comment gets reopened",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Acomment_reopened",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-reopened.json"
    },
    {
      "name": "issue:created",
      "resource": "issue",
      "description": "Someone files an issue",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#issue%3Acreated",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/issue-created.json"
    },
    {
      "name": "issue:updated",
      "resource": "issue",
      "description": "Someone changes an issue, such as its status",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#issue%3Aupdated",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/issue-updated.json"
    },
    {
      "name": "issue:comment_created",
      "resource": "issue",
      "description": "Someone comments on an issue",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#issue%3Acomment_created",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/issue-comment-created.json"
    },
    {
      "name": "pipeline:span_created",
      "resource": "pipeline",
      "description": "Finished pipeline run emits OpenTelemetry trace spans",
      "confidence": "documented",
      "schema_source": "from Bitbucket docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/bitbucket/events#pipeline%3Aspan_created",
      "json": "https://hookdeck.com/webhooks/bitbucket/events/pipeline-span-created.json"
    }
  ]
}