# Bitbucket webhook events

Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/bitbucket/mcp-events).

These pages cover Bitbucket Cloud. Bitbucket Data Center is a separate self-managed product, with its own event keys, such as `repo:refs_changed`, and [its own webhook docs](https://confluence.atlassian.com/bitbucketserver/manage-webhooks-938025878.html).

Agent skill: `npx skills add hookdeck/webhook-skills --skill bitbucket-webhooks` ([details](https://hookdeck.com/webhooks/bitbucket/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Bitbucket's official docs](https://support.atlassian.com/bitbucket-cloud/docs/event-payloads/).

[Overview](https://hookdeck.com/webhooks/bitbucket) · [Webhook events (29)](https://hookdeck.com/webhooks/bitbucket/events) · [MCP events](https://hookdeck.com/webhooks/bitbucket/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/bitbucket/verify) · [Production guide](https://hookdeck.com/webhooks/bitbucket/guide-duplicates-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/bitbucket/skill)

## issue

### issue:created

Confidence: documented · Schema: official schema

Someone files an issue

Identified by: x-event-key header · Object: `issue`

```json
{
  "actor": { … },
  "issue": { … },
  "repository": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/issue-created.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/issue-created.json)

### issue:updated

Confidence: documented · Schema: official schema

Someone changes an issue, such as its status

Identified by: x-event-key header · Object: `issue`

```json
{
  "actor": { … },
  "issue": { … },
  "repository": { … },
  "comment": { … },
  "changes": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/issue-updated.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/issue-updated.json)

### issue:comment_created

Confidence: documented · Schema: official schema

Someone comments on an issue

Identified by: x-event-key header · Object: `issue`

```json
{
  "actor": { … },
  "repository": { … },
  "issue": { … },
  "comment": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/issue-comment-created.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/issue-comment-created.json)

## pullrequest

### pullrequest:created

Confidence: verified · Schema: from a captured delivery

Someone opens a pull request

Identified by: x-event-key header · Object: `pullrequest`

```json
{
  "repository": { … },
  "actor": { … },
  "pullrequest": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-created.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-attempt-number`, `x-b3-sampled`, `x-b3-spanid`, `x-b3-traceid`, `x-event-key`, `x-event-time`, `x-hook-uuid`, `x-request-uuid`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-created.json)

### pullrequest:updated

Confidence: verified · Schema: from a captured delivery

Someone edits or updates a pull request

Identified by: x-event-key header · Object: `pullrequest`

```json
{
  "repository": { … },
  "actor": { … },
  "pullrequest": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-updated.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-attempt-number`, `x-b3-sampled`, `x-b3-spanid`, `x-b3-traceid`, `x-event-key`, `x-event-time`, `x-hook-uuid`, `x-request-uuid`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-updated.json)

### pullrequest:push

Confidence: documented · Schema: No payload yet

Pull request receives a push; payload not documented

Identified by: x-event-key header · Object: `pullrequest`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-push.json)

### pullrequest:changes_request_created

Confidence: documented · Schema: official schema

Reviewer asks for changes on a pull request

Identified by: x-event-key header · Object: `pullrequest`

```json
{
  "actor": { … },
  "pullrequest": { … },
  "repository": { … },
  "changes_request": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-changes-request-created.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-changes-request-created.json)

### pullrequest:changes_request_removed

Confidence: documented · Schema: official schema

Reviewer withdraws a request for changes

Identified by: x-event-key header · Object: `pullrequest`

```json
{
  "actor": { … },
  "pullrequest": { … },
  "repository": { … },
  "changes_request": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-changes-request-removed.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-changes-request-removed.json)

### pullrequest:approved

Confidence: verified · Schema: from a captured delivery

Reviewer approves a pull request

Identified by: x-event-key header · Object: `pullrequest`

```json
{
  "repository": { … },
  "actor": { … },
  "pullrequest": { … },
  "approval": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-approved.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-attempt-number`, `x-b3-sampled`, `x-b3-spanid`, `x-b3-traceid`, `x-event-key`, `x-event-time`, `x-hook-uuid`, `x-request-uuid`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-approved.json)

### pullrequest:unapproved

Confidence: verified · Schema: from a captured delivery

Reviewer withdraws a pull request approval

Identified by: x-event-key header · Object: `pullrequest`

```json
{
  "repository": { … },
  "actor": { … },
  "pullrequest": { … },
  "approval": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-unapproved.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-attempt-number`, `x-b3-sampled`, `x-b3-spanid`, `x-b3-traceid`, `x-event-key`, `x-event-time`, `x-hook-uuid`, `x-request-uuid`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-unapproved.json)

### pullrequest:fulfilled

Confidence: verified · Schema: from a captured delivery

Pull request gets merged

Identified by: x-event-key header · Object: `pullrequest`

```json
{
  "repository": { … },
  "actor": { … },
  "pullrequest": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-fulfilled.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-attempt-number`, `x-b3-sampled`, `x-b3-spanid`, `x-b3-traceid`, `x-event-key`, `x-event-time`, `x-hook-uuid`, `x-request-uuid`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-fulfilled.json)

### pullrequest:rejected

Confidence: documented · Schema: official schema

Pull request gets declined

Identified by: x-event-key header · Object: `pullrequest`

```json
{
  "actor": { … },
  "pullrequest": { … },
  "repository": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-rejected.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-rejected.json)

### pullrequest:comment_created

Confidence: verified · Schema: from a captured delivery

New comment on a pull request

Identified by: x-event-key header · Object: `pullrequest`

```json
{
  "repository": { … },
  "actor": { … },
  "pullrequest": { … },
  "comment": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-created.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-attempt-number`, `x-b3-sampled`, `x-b3-spanid`, `x-b3-traceid`, `x-event-key`, `x-event-time`, `x-hook-uuid`, `x-request-uuid`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-created.json)

### pullrequest:comment_updated

Confidence: documented · Schema: official schema

Pull request comment edited; quick repeat edits are skipped

Identified by: x-event-key header · Object: `pullrequest`

```json
{
  "actor": { … },
  "repository": { … },
  "pullrequest": { … },
  "comment": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-updated.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-updated.json)

### pullrequest:comment_deleted

Confidence: documented · Schema: official schema

Pull request comment gets removed

Identified by: x-event-key header · Object: `pullrequest`

```json
{
  "actor": { … },
  "repository": { … },
  "pullrequest": { … },
  "comment": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-deleted.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-deleted.json)

### pullrequest:comment_resolved

Confidence: documented · Schema: official schema

Pull request comment gets marked resolved

Identified by: x-event-key header · Object: `pullrequest`

```json
{
  "actor": { … },
  "repository": { … },
  "pullrequest": { … },
  "comment": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-resolved.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-resolved.json)

### pullrequest:comment_reopened

Confidence: documented · Schema: official schema

Resolved pull request comment gets reopened

Identified by: x-event-key header · Object: `pullrequest`

```json
{
  "actor": { … },
  "repository": { … },
  "pullrequest": { … },
  "comment": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-reopened.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pullrequest-comment-reopened.json)

## repo

### repo:push

Confidence: verified · Schema: from a captured delivery

A push creates, updates or deletes a branch or tag

Identified by: x-event-key header · Object: `repo`

```json
{
  "push": { … },
  "repository": { … },
  "actor": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-push.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-attempt-number`, `x-b3-sampled`, `x-b3-spanid`, `x-b3-traceid`, `x-event-key`, `x-event-time`, `x-hook-uuid`, `x-request-uuid`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-push.json)

### repo:fork

Confidence: verified · Schema: from a captured delivery

Someone forks the repository

Identified by: x-event-key header · Object: `repo`

```json
{
  "repository": { … },
  "actor": { … },
  "fork": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-fork.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-attempt-number`, `x-b3-sampled`, `x-b3-spanid`, `x-b3-traceid`, `x-event-key`, `x-event-time`, `x-hook-uuid`, `x-request-uuid`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-fork.json)

### repo:updated

Confidence: verified · Schema: from a captured delivery

Repository name, description, website or language changes

Identified by: x-event-key header · Object: `repo`

```json
{
  "repository": { … },
  "actor": { … },
  "changes": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-updated.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-attempt-number`, `x-b3-sampled`, `x-b3-spanid`, `x-b3-traceid`, `x-event-key`, `x-event-time`, `x-hook-uuid`, `x-request-uuid`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-updated.json)

### repo:transfer

Confidence: documented · Schema: No payload yet

Recipient accepts a repository transfer; workspace webhooks only

Identified by: x-event-key header · Object: `repo`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-transfer.json)

### repo:commit_comment_created

Confidence: verified · Schema: from a captured delivery

Someone comments on a commit

Identified by: x-event-key header · Object: `repo`

```json
{
  "repository": { … },
  "actor": { … },
  "comment": { … },
  "commit": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-commit-comment-created.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-attempt-number`, `x-b3-sampled`, `x-b3-spanid`, `x-b3-traceid`, `x-event-key`, `x-event-time`, `x-hook-uuid`, `x-request-uuid`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-commit-comment-created.json)

### repo:commit_status_created

Confidence: documented · Schema: official schema

A build tool reports a new commit status

Identified by: x-event-key header · Object: `repo`

```json
{
  "actor": { … },
  "repository": { … },
  "commit_status": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-commit-status-created.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-commit-status-created.json)

### repo:commit_status_updated

Confidence: documented · Schema: official schema

A build tool changes an existing commit status

Identified by: x-event-key header · Object: `repo`

```json
{
  "actor": { … },
  "repository": { … },
  "commit_status": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-commit-status-updated.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-commit-status-updated.json)

### repo:deleted

Confidence: documented · Schema: from Bitbucket docs (example)

Hard deletion finishes, up to 30 days later; workspace webhooks only

Identified by: x-event-key header · Object: `repo`

```json
{
  "repository": { … },
  "actor": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-deleted.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-deleted.json)

### repo:created

Confidence: documented · Schema: No payload yet

New repository appears; workspace webhooks only

Identified by: x-event-key header · Object: `repo`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-created.json)

### repo:imported

Confidence: documented · Schema: No payload yet

A repository gets imported; workspace webhooks only

Identified by: x-event-key header · Object: `repo`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/repo-imported.json)

## Other Bitbucket events

### pipeline:span_created

Confidence: documented · Schema: from Bitbucket docs (example)

Finished pipeline run emits OpenTelemetry trace spans

Identified by: x-event-key header · Object: `pipeline`

```json
{
  "resourceSpans": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pipeline-span-created.json)

From Bitbucket docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/pipeline-span-created.json)

### project:updated

Confidence: documented · Schema: No payload yet

A project field changes; workspace webhooks only

Identified by: x-event-key header · Object: `project`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/bitbucket/events/project-updated.json)

---

Not affiliated with Bitbucket. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/bitbucket.json) · [Report a correction](https://hookdeck.com/contact)
