GitLab · AsyncAPI Specification
GitLab Webhooks
Version 4
GitLab Webhooks deliver HTTP POST payloads to a configured URL whenever specified events occur in a GitLab project or group, such as pushes, merge requests, issues, pipeline status changes, and deployments. Webhooks are configured at the project or group level and include an X-Gitlab-Token header for payload signature verification.
Channels
/webhook
Receive a GitLab webhook event
The endpoint that receives all GitLab webhook event deliveries. The specific event type is identified by the X-Gitlab-Event header.
Messages
PushEvent
Push Hook
Triggered when code is pushed to a repository branch.
TagPushEvent
Tag Push Hook
Triggered when a tag is created or deleted.
MergeRequestEvent
Merge Request Hook
Triggered when a merge request is created, updated, or closed.
IssueEvent
Issue Hook
Triggered when an issue is created, updated, or closed.
NoteEvent
Note Hook
Triggered when a comment is added on a commit, MR, issue, or snippet.
PipelineEvent
Pipeline Hook
Triggered when a CI/CD pipeline changes status.
JobEvent
Job Hook
Triggered when a CI/CD job changes status.
DeploymentEvent
Deployment Hook
Triggered when a deployment starts, succeeds, fails, or is canceled.
ReleaseEvent
Release Hook
Triggered when a release is created, updated, or deleted.
MemberEvent
Member Hook
Triggered when a group member is added, removed, or changes access level.
WikiPageEvent
Wiki Page Hook
Triggered when a wiki page is created, updated, or deleted.
Servers
https
webhook-receiver
{webhookUrl}
Your webhook receiver endpoint. GitLab sends POST requests to this URL when subscribed events occur in the configured project or group.