Bitbucket webhook events

29 Bitbucket event types in 3 resources, plus Other Bitbucket events. 24 have sample payloads.

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.

Every event here can also reach agents as an MCP event through Hookdeck: MCP events →

issue

issue:created

documented official schema

Someone files an issue

Identified by x-event-key header Resource issue

bitbucket-issue-created.json
{
  "actor": { … },
  "issue": { … },
  "repository": { … }
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

issue:updated

documented official schema

Someone changes an issue, such as its status

Identified by x-event-key header Resource issue

bitbucket-issue-updated.json
{
  "actor": { … },
  "issue": { … },
  "repository": { … },
  "comment": { … },
  "changes": { … }
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

issue:comment_created

documented official schema

Someone comments on an issue

Identified by x-event-key header Resource issue

bitbucket-issue-comment-created.json
{
  "actor": { … },
  "repository": { … },
  "issue": { … },
  "comment": { … }
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

pullrequest

pullrequest:created

verified from a captured delivery

Someone opens a pull request

Identified by x-event-key header Resource pullrequest

bitbucket-pullrequest-created.json
{
  "repository": { … },
  "actor": { … },
  "pullrequest": { … }
}

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

Send example to Inspect → View as JSON

pullrequest:updated

verified from a captured delivery

Someone edits or updates a pull request

Identified by x-event-key header Resource pullrequest

bitbucket-pullrequest-updated.json
{
  "repository": { … },
  "actor": { … },
  "pullrequest": { … }
}

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

Send example to Inspect → View as JSON

pullrequest:push

documented No payload yet

Pull request receives a push; payload not documented

Identified by x-event-key header Resource pullrequest

No payload yet.

Help fill this in → View as JSON

pullrequest:changes_request_created

documented official schema

Reviewer asks for changes on a pull request

Identified by x-event-key header Resource pullrequest

bitbucket-pullrequest-changes-request-created.json
{
  "actor": { … },
  "pullrequest": { … },
  "repository": { … },
  "changes_request": { … }
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

pullrequest:changes_request_removed

documented official schema

Reviewer withdraws a request for changes

Identified by x-event-key header Resource pullrequest

bitbucket-pullrequest-changes-request-removed.json
{
  "actor": { … },
  "pullrequest": { … },
  "repository": { … },
  "changes_request": { … }
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

pullrequest:approved

verified from a captured delivery

Reviewer approves a pull request

Identified by x-event-key header Resource pullrequest

bitbucket-pullrequest-approved.json
{
  "repository": { … },
  "actor": { … },
  "pullrequest": { … },
  "approval": { … }
}

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

Send example to Inspect → View as JSON

pullrequest:unapproved

verified from a captured delivery

Reviewer withdraws a pull request approval

Identified by x-event-key header Resource pullrequest

bitbucket-pullrequest-unapproved.json
{
  "repository": { … },
  "actor": { … },
  "pullrequest": { … },
  "approval": { … }
}

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

Send example to Inspect → View as JSON

pullrequest:fulfilled

verified from a captured delivery

Pull request gets merged

Identified by x-event-key header Resource pullrequest

bitbucket-pullrequest-fulfilled.json
{
  "repository": { … },
  "actor": { … },
  "pullrequest": { … }
}

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

Send example to Inspect → View as JSON

pullrequest:rejected

documented official schema

Pull request gets declined

Identified by x-event-key header Resource pullrequest

bitbucket-pullrequest-rejected.json
{
  "actor": { … },
  "pullrequest": { … },
  "repository": { … }
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

pullrequest:comment_created

verified from a captured delivery

New comment on a pull request

Identified by x-event-key header Resource pullrequest

bitbucket-pullrequest-comment-created.json
{
  "repository": { … },
  "actor": { … },
  "pullrequest": { … },
  "comment": { … }
}

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

Send example to Inspect → View as JSON

pullrequest:comment_updated

documented official schema

Pull request comment edited; quick repeat edits are skipped

Identified by x-event-key header Resource pullrequest

bitbucket-pullrequest-comment-updated.json
{
  "actor": { … },
  "repository": { … },
  "pullrequest": { … },
  "comment": { … }
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

pullrequest:comment_deleted

documented official schema

Pull request comment gets removed

Identified by x-event-key header Resource pullrequest

bitbucket-pullrequest-comment-deleted.json
{
  "actor": { … },
  "repository": { … },
  "pullrequest": { … },
  "comment": { … }
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

pullrequest:comment_resolved

documented official schema

Pull request comment gets marked resolved

Identified by x-event-key header Resource pullrequest

bitbucket-pullrequest-comment-resolved.json
{
  "actor": { … },
  "repository": { … },
  "pullrequest": { … },
  "comment": { … }
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

pullrequest:comment_reopened

documented official schema

Resolved pull request comment gets reopened

Identified by x-event-key header Resource pullrequest

bitbucket-pullrequest-comment-reopened.json
{
  "actor": { … },
  "repository": { … },
  "pullrequest": { … },
  "comment": { … }
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

repo

repo:push

verified from a captured delivery

A push creates, updates or deletes a branch or tag

Identified by x-event-key header Resource repo

bitbucket-repo-push.json
{
  "push": { … },
  "repository": { … },
  "actor": { … }
}

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

Send example to Inspect → View as JSON

repo:fork

verified from a captured delivery

Someone forks the repository

Identified by x-event-key header Resource repo

bitbucket-repo-fork.json
{
  "repository": { … },
  "actor": { … },
  "fork": { … }
}

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

Send example to Inspect → View as JSON

repo:updated

verified from a captured delivery

Repository name, description, website or language changes

Identified by x-event-key header Resource repo

bitbucket-repo-updated.json
{
  "repository": { … },
  "actor": { … },
  "changes": { … }
}

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

Send example to Inspect → View as JSON

repo:transfer

documented No payload yet

Recipient accepts a repository transfer; workspace webhooks only

Identified by x-event-key header Resource repo

No payload yet.

Help fill this in → View as JSON

repo:commit_comment_created

verified from a captured delivery

Someone comments on a commit

Identified by x-event-key header Resource repo

bitbucket-repo-commit-comment-created.json
{
  "repository": { … },
  "actor": { … },
  "comment": { … },
  "commit": { … }
}

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

Send example to Inspect → View as JSON

repo:commit_status_created

documented official schema

A build tool reports a new commit status

Identified by x-event-key header Resource repo

bitbucket-repo-commit-status-created.json
{
  "actor": { … },
  "repository": { … },
  "commit_status": { … }
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

repo:commit_status_updated

documented official schema

A build tool changes an existing commit status

Identified by x-event-key header Resource repo

bitbucket-repo-commit-status-updated.json
{
  "actor": { … },
  "repository": { … },
  "commit_status": { … }
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

repo:deleted

documented from Bitbucket docs (example)

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

Identified by x-event-key header Resource repo

bitbucket-repo-deleted.json
{
  "repository": { … },
  "actor": { … }
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

repo:created

documented No payload yet

New repository appears; workspace webhooks only

Identified by x-event-key header Resource repo

No payload yet.

Help fill this in → View as JSON

repo:imported

documented No payload yet

A repository gets imported; workspace webhooks only

Identified by x-event-key header Resource repo

No payload yet.

Help fill this in → View as JSON

Other Bitbucket events

pipeline:span_created

documented from Bitbucket docs (example)

Finished pipeline run emits OpenTelemetry trace spans

Identified by x-event-key header

bitbucket-pipeline-span-created.json
{
  "resourceSpans": [ … ]
}

From Bitbucket docs

  • Content type application/json

Send example to Inspect → View as JSON

project:updated

documented No payload yet

A project field changes; workspace webhooks only

Identified by x-event-key header

No payload yet.

Help fill this in → View as JSON

Route Bitbucket events by type.

Event Gateway receives every Bitbucket delivery and filters and routes it by event type, so each service gets only the events it handles.

Not affiliated with Bitbucket. Facts are compiled from public sources and linked inline.