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
issue:created Someone files an issue
Identified by x-event-key header
Resource issue
{
"actor": { … },
"issue": { … },
"repository": { … }
} From Bitbucket docs
-
Content type
application/json
issue:updated
documented official schema
issue:updated Someone changes an issue, such as its status
Identified by x-event-key header
Resource issue
{
"actor": { … },
"issue": { … },
"repository": { … },
"comment": { … },
"changes": { … }
} From Bitbucket docs
-
Content type
application/json
issue:comment_created
documented official schema
issue:comment_created Someone comments on an issue
Identified by x-event-key header
Resource issue
{
"actor": { … },
"repository": { … },
"issue": { … },
"comment": { … }
} From Bitbucket docs
-
Content type
application/json
pullrequest
pullrequest:created
verified from a captured delivery
pullrequest:created Someone opens a pull request
Identified by x-event-key header
Resource pullrequest
{
"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
pullrequest:updated
verified from a captured delivery
pullrequest:updated Someone edits or updates a pull request
Identified by x-event-key header
Resource pullrequest
{
"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
pullrequest:push
documented No payload yet
pullrequest:push Pull request receives a push; payload not documented
Identified by x-event-key header
Resource pullrequest
No payload yet.
pullrequest:changes_request_created
documented official schema
pullrequest:changes_request_created Reviewer asks for changes on a pull request
Identified by x-event-key header
Resource pullrequest
{
"actor": { … },
"pullrequest": { … },
"repository": { … },
"changes_request": { … }
} From Bitbucket docs
-
Content type
application/json
pullrequest:changes_request_removed
documented official schema
pullrequest:changes_request_removed Reviewer withdraws a request for changes
Identified by x-event-key header
Resource pullrequest
{
"actor": { … },
"pullrequest": { … },
"repository": { … },
"changes_request": { … }
} From Bitbucket docs
-
Content type
application/json
pullrequest:approved
verified from a captured delivery
pullrequest:approved Reviewer approves a pull request
Identified by x-event-key header
Resource pullrequest
{
"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
pullrequest:unapproved
verified from a captured delivery
pullrequest:unapproved Reviewer withdraws a pull request approval
Identified by x-event-key header
Resource pullrequest
{
"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
pullrequest:fulfilled
verified from a captured delivery
pullrequest:fulfilled Pull request gets merged
Identified by x-event-key header
Resource pullrequest
{
"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
pullrequest:rejected
documented official schema
pullrequest:rejected Pull request gets declined
Identified by x-event-key header
Resource pullrequest
{
"actor": { … },
"pullrequest": { … },
"repository": { … }
} From Bitbucket docs
-
Content type
application/json
pullrequest:comment_created
verified from a captured delivery
pullrequest:comment_created New comment on a pull request
Identified by x-event-key header
Resource pullrequest
{
"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
pullrequest:comment_updated
documented official schema
pullrequest:comment_updated Pull request comment edited; quick repeat edits are skipped
Identified by x-event-key header
Resource pullrequest
{
"actor": { … },
"repository": { … },
"pullrequest": { … },
"comment": { … }
} From Bitbucket docs
-
Content type
application/json
pullrequest:comment_deleted
documented official schema
pullrequest:comment_deleted Pull request comment gets removed
Identified by x-event-key header
Resource pullrequest
{
"actor": { … },
"repository": { … },
"pullrequest": { … },
"comment": { … }
} From Bitbucket docs
-
Content type
application/json
pullrequest:comment_resolved
documented official schema
pullrequest:comment_resolved Pull request comment gets marked resolved
Identified by x-event-key header
Resource pullrequest
{
"actor": { … },
"repository": { … },
"pullrequest": { … },
"comment": { … }
} From Bitbucket docs
-
Content type
application/json
pullrequest:comment_reopened
documented official schema
pullrequest:comment_reopened Resolved pull request comment gets reopened
Identified by x-event-key header
Resource pullrequest
{
"actor": { … },
"repository": { … },
"pullrequest": { … },
"comment": { … }
} From Bitbucket docs
-
Content type
application/json
repo
repo:push
verified from a captured delivery
repo:push A push creates, updates or deletes a branch or tag
Identified by x-event-key header
Resource repo
{
"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
repo:fork
verified from a captured delivery
repo:fork Someone forks the repository
Identified by x-event-key header
Resource repo
{
"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
repo:updated
verified from a captured delivery
repo:updated Repository name, description, website or language changes
Identified by x-event-key header
Resource repo
{
"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
repo:transfer
documented No payload yet
repo:transfer Recipient accepts a repository transfer; workspace webhooks only
Identified by x-event-key header
Resource repo
No payload yet.
repo:commit_comment_created
verified from a captured delivery
repo:commit_comment_created Someone comments on a commit
Identified by x-event-key header
Resource repo
{
"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
repo:commit_status_created
documented official schema
repo:commit_status_created A build tool reports a new commit status
Identified by x-event-key header
Resource repo
{
"actor": { … },
"repository": { … },
"commit_status": { … }
} From Bitbucket docs
-
Content type
application/json
repo:commit_status_updated
documented official schema
repo:commit_status_updated A build tool changes an existing commit status
Identified by x-event-key header
Resource repo
{
"actor": { … },
"repository": { … },
"commit_status": { … }
} From Bitbucket docs
-
Content type
application/json
repo:deleted
documented from Bitbucket docs (example)
repo:deleted Hard deletion finishes, up to 30 days later; workspace webhooks only
Identified by x-event-key header
Resource repo
{
"repository": { … },
"actor": { … }
} From Bitbucket docs
-
Content type
application/json
repo:created
documented No payload yet
repo:created New repository appears; workspace webhooks only
Identified by x-event-key header
Resource repo
No payload yet.
repo:imported
documented No payload yet
repo:imported A repository gets imported; workspace webhooks only
Identified by x-event-key header
Resource repo
No payload yet.
Other Bitbucket events
pipeline:span_created
documented from Bitbucket docs (example)
pipeline:span_created Finished pipeline run emits OpenTelemetry trace spans
Identified by x-event-key header
{
"resourceSpans": [ … ]
} From Bitbucket docs
-
Content type
application/json
project:updated
documented No payload yet
project:updated A project field changes; workspace webhooks only
Identified by x-event-key header
No payload yet.
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.